- knowledgeBaseArticlesTotalCount
Browse queries, mutations, and types in the schema reference. For authentication, endpoint URLs, and domain guides, see the API Overview.
Retrieve a single knowledge base category by ID.
Arguments
Return type
KnowledgeUnique code identifier for programmatic access.
The category title.
Description of what this category covers.
Articles in this category, optionally filtered by status.
Icon identifier for the category.
User ID of the category creator.
When this category was created.
User ID of the last modifier.
When this category was last modified.
Parent category ID for nested categorization.
The first topic this category belongs to.
Users who have authored articles in this category.
Count of articles in this category, optionally filtered by status.
Total article count in this category.
query knowledgeBaseCategoryDetail($_id: String!) {
knowledgeBaseCategoryDetail(_id: $_id) {
_id
code
title
description
articles(
# Arguments Here
) {
_id
code
title
summary
content
status
isPrivate
reactionChoices
reactionCounts
createdBy
createdUser {
__typename
# ...UserFragment
}
createdDate
modifiedBy
modifiedDate
topicId
categoryId
viewCount
attachments {
__typename
# ...AttachmentFragment
}
image {
__typename
# ...AttachmentFragment
}
pdfAttachment {
__typename
# ...PdfAttachmentFragment
}
publishedUserId
publishedUser {
__typename
# ...UserFragment
}
scheduledDate
forms {
__typename
# ...FormCodeFragment
}
}
icon
createdBy
createdDate
modifiedBy
modifiedDate
parentCategoryId
firstTopic {
_id
code
title
description
categories {
__typename
# ...KnowledgeBaseCategoryFragment
}
workspace {
__typename
# ...WorkspaceFragment
}
color
backgroundImage
languageCode
createdBy
createdDate
modifiedBy
modifiedDate
parentCategories {
__typename
# ...KnowledgeBaseParentCategoryFragment
}
}
authors {
_id
createdAt
username
email
userPreferences
availability
isActive
details {
__typename
# ...UserDetailsTypeFragment
}
links
status
emailSignatures
groupIds
workspaceIds
isSubscribed
customFieldsData
workspaces {
__typename
# ...WorkspaceFragment
}
isOwner
permissionActions
configs
configsConstants
onboardingHistory {
__typename
# ...OnboardingHistoryFragment
}
departmentIds
departments {
__typename
# ...DepartmentFragment
}
branchIds
branches {
__typename
# ...BranchFragment
}
positionIds
positions {
__typename
# ...PositionFragment
}
score
scoreCategories {
__typename
# ...ScoreCategoriesFragment
}
leaderBoardPosition
employeeId
isOnline
}
numOfArticles(
# Arguments Here
)
countArticles
}
}{ "_id": "Example String" }
{ "data": { "_id": "Example String", "code": "Example String", "title": "Example String", "description": "Example String", "articles": [ { "_id": "Example String", "code": "Example String", "title": "Example String", "summary": "Example String", "content": "Example String", "status": "Example String", "isPrivate": true, "reactionChoices": [ "Example String" ], "reactionCounts": "Example Custom Scalar", "createdBy": "Example String", "createdUser": { "__typename": "User" }, "createdDate": "Example Custom Scalar", "modifiedBy": "Example String", "modifiedDate": "Example Custom Scalar", "topicId": "Example String", "categoryId": "Example String", "viewCount": 40, "attachments": [ { "__typename": "Attachment" } ], "image": { "__typename": "Attachment" }, "pdfAttachment": { "__typename": "PdfAttachment" }, "publishedUserId": "Example String", "publishedUser": { "__typename": "User" }, "scheduledDate": "Example Custom Scalar", "forms": [ { "__typename": "FormCode" } ] } ], "icon": "Example String", "createdBy": "Example String", "createdDate": "Example Custom Scalar", "modifiedBy": "Example String", "modifiedDate": "Example Custom Scalar", "parentCategoryId": "Example String", "firstTopic": { "_id": "Example String", "code": "Example String", "title": "Example String", "description": "Example String", "categories": [ { "__typename": "KnowledgeBaseCategory" } ], "workspace": { "__typename": "Workspace" }, "color": "Example String", "backgroundImage": "Example String", "languageCode": "Example String", "createdBy": "Example String", "createdDate": "Example Custom Scalar", "modifiedBy": "Example String", "modifiedDate": "Example Custom Scalar", "parentCategories": [ { "__typename": "KnowledgeBaseParentCategory" } ] }, "authors": [ { "_id": "Example String", "createdAt": "Example Custom Scalar", "username": "Example String", "email": "Example String", "userPreferences": "Example Custom Scalar", "availability": "offline", "isActive": true, "details": { "__typename": "UserDetailsType" }, "links": "Example Custom Scalar", "status": "Example String", "emailSignatures": "Example Custom Scalar", "groupIds": [ "Example String" ], "workspaceIds": [ "Example String" ], "isSubscribed": "Example String", "customFieldsData": "Example Custom Scalar", "workspaces": [ { "__typename": "Workspace" } ], "isOwner": true, "permissionActions": "Example Custom Scalar", "configs": "Example Custom Scalar", "configsConstants": [ "Example Custom Scalar" ], "onboardingHistory": { "__typename": "OnboardingHistory" }, "departmentIds": [ "Example String" ], "departments": [ { "__typename": "Department" } ], "branchIds": [ "Example String" ], "branches": [ { "__typename": "Branch" } ], "positionIds": [ "Example String" ], "positions": [ { "__typename": "Position" } ], "score": 40, "scoreCategories": { "__typename": "ScoreCategories" }, "leaderBoardPosition": 40, "employeeId": "Example String", "isOnline": true } ], "numOfArticles": 40, "countArticles": 40 } }
Return the total number of categories matching the given filters.
Arguments
Return type
IntThe Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
query knowledgeBaseCategoriesTotalCount($topicIds: [String], $codes: [String]) {
knowledgeBaseCategoriesTotalCount(topicIds: $topicIds, codes: $codes)
}{ "topicIds": [ "Example String" ], "codes": [ "Example String" ] }
{ "data": 40 }
Return the most recently created knowledge base category.
Return type
KnowledgeUnique code identifier for programmatic access.
The category title.
Description of what this category covers.
Articles in this category, optionally filtered by status.
Icon identifier for the category.
User ID of the category creator.
When this category was created.
User ID of the last modifier.
When this category was last modified.
Parent category ID for nested categorization.
The first topic this category belongs to.
Users who have authored articles in this category.
Count of articles in this category, optionally filtered by status.
Total article count in this category.
query knowledgeBaseCategoriesGetLast {
knowledgeBaseCategoriesGetLast {
_id
code
title
description
articles(
# Arguments Here
) {
_id
code
title
summary
content
status
isPrivate
reactionChoices
reactionCounts
createdBy
createdUser {
__typename
# ...UserFragment
}
createdDate
modifiedBy
modifiedDate
topicId
categoryId
viewCount
attachments {
__typename
# ...AttachmentFragment
}
image {
__typename
# ...AttachmentFragment
}
pdfAttachment {
__typename
# ...PdfAttachmentFragment
}
publishedUserId
publishedUser {
__typename
# ...UserFragment
}
scheduledDate
forms {
__typename
# ...FormCodeFragment
}
}
icon
createdBy
createdDate
modifiedBy
modifiedDate
parentCategoryId
firstTopic {
_id
code
title
description
categories {
__typename
# ...KnowledgeBaseCategoryFragment
}
workspace {
__typename
# ...WorkspaceFragment
}
color
backgroundImage
languageCode
createdBy
createdDate
modifiedBy
modifiedDate
parentCategories {
__typename
# ...KnowledgeBaseParentCategoryFragment
}
}
authors {
_id
createdAt
username
email
userPreferences
availability
isActive
details {
__typename
# ...UserDetailsTypeFragment
}
links
status
emailSignatures
groupIds
workspaceIds
isSubscribed
customFieldsData
workspaces {
__typename
# ...WorkspaceFragment
}
isOwner
permissionActions
configs
configsConstants
onboardingHistory {
__typename
# ...OnboardingHistoryFragment
}
departmentIds
departments {
__typename
# ...DepartmentFragment
}
branchIds
branches {
__typename
# ...BranchFragment
}
positionIds
positions {
__typename
# ...PositionFragment
}
score
scoreCategories {
__typename
# ...ScoreCategoriesFragment
}
leaderBoardPosition
employeeId
isOnline
}
numOfArticles(
# Arguments Here
)
countArticles
}
}{ "data": { "_id": "Example String", "code": "Example String", "title": "Example String", "description": "Example String", "articles": [ { "_id": "Example String", "code": "Example String", "title": "Example String", "summary": "Example String", "content": "Example String", "status": "Example String", "isPrivate": true, "reactionChoices": [ "Example String" ], "reactionCounts": "Example Custom Scalar", "createdBy": "Example String", "createdUser": { "__typename": "User" }, "createdDate": "Example Custom Scalar", "modifiedBy": "Example String", "modifiedDate": "Example Custom Scalar", "topicId": "Example String", "categoryId": "Example String", "viewCount": 40, "attachments": [ { "__typename": "Attachment" } ], "image": { "__typename": "Attachment" }, "pdfAttachment": { "__typename": "PdfAttachment" }, "publishedUserId": "Example String", "publishedUser": { "__typename": "User" }, "scheduledDate": "Example Custom Scalar", "forms": [ { "__typename": "FormCode" } ] } ], "icon": "Example String", "createdBy": "Example String", "createdDate": "Example Custom Scalar", "modifiedBy": "Example String", "modifiedDate": "Example Custom Scalar", "parentCategoryId": "Example String", "firstTopic": { "_id": "Example String", "code": "Example String", "title": "Example String", "description": "Example String", "categories": [ { "__typename": "KnowledgeBaseCategory" } ], "workspace": { "__typename": "Workspace" }, "color": "Example String", "backgroundImage": "Example String", "languageCode": "Example String", "createdBy": "Example String", "createdDate": "Example Custom Scalar", "modifiedBy": "Example String", "modifiedDate": "Example Custom Scalar", "parentCategories": [ { "__typename": "KnowledgeBaseParentCategory" } ] }, "authors": [ { "_id": "Example String", "createdAt": "Example Custom Scalar", "username": "Example String", "email": "Example String", "userPreferences": "Example Custom Scalar", "availability": "offline", "isActive": true, "details": { "__typename": "UserDetailsType" }, "links": "Example Custom Scalar", "status": "Example String", "emailSignatures": "Example Custom Scalar", "groupIds": [ "Example String" ], "workspaceIds": [ "Example String" ], "isSubscribed": "Example String", "customFieldsData": "Example Custom Scalar", "workspaces": [ { "__typename": "Workspace" } ], "isOwner": true, "permissionActions": "Example Custom Scalar", "configs": "Example Custom Scalar", "configsConstants": [ "Example Custom Scalar" ], "onboardingHistory": { "__typename": "OnboardingHistory" }, "departmentIds": [ "Example String" ], "departments": [ { "__typename": "Department" } ], "branchIds": [ "Example String" ], "branches": [ { "__typename": "Branch" } ], "positionIds": [ "Example String" ], "positions": [ { "__typename": "Position" } ], "score": 40, "scoreCategories": { "__typename": "ScoreCategories" }, "leaderBoardPosition": 40, "employeeId": "Example String", "isOnline": true } ], "numOfArticles": 40, "countArticles": 40 } }
List knowledge base articles with pagination, search, sorting, and filtering.
Arguments
Return type
KnowledgeThe list of articles for the current page.
Pagination metadata.
query knowledgeBaseArticles(
$searchValue: String
$page: Int
$perPage: Int
$categoryIds: [String]
$articleIds: [String]
$codes: [String]
$topicIds: [String]
$sortField: String
$sortDirection: SortDirection
$status: String
) {
knowledgeBaseArticles(
searchValue: $searchValue
page: $page
perPage: $perPage
categoryIds: $categoryIds
articleIds: $articleIds
codes: $codes
topicIds: $topicIds
sortField: $sortField
sortDirection: $sortDirection
status: $status
) {
data {
_id
code
title
summary
content
status
isPrivate
reactionChoices
reactionCounts
createdBy
createdUser {
__typename
# ...UserFragment
}
createdDate
modifiedBy
modifiedDate
topicId
categoryId
viewCount
attachments {
__typename
# ...AttachmentFragment
}
image {
__typename
# ...AttachmentFragment
}
pdfAttachment {
__typename
# ...PdfAttachmentFragment
}
publishedUserId
publishedUser {
__typename
# ...UserFragment
}
scheduledDate
forms {
__typename
# ...FormCodeFragment
}
}
pagination {
currentPage
perPage
totalCount
totalPages
hasNextPage
hasPreviousPage
}
}
}{ "searchValue": "Example String", "page": 40, "perPage": 40, "categoryIds": [ "Example String" ], "articleIds": [ "Example String" ], "codes": [ "Example String" ], "topicIds": [ "Example String" ], "sortField": "Example String", "sortDirection": "asc", "status": "Example String" }
{ "data": { "data": [ { "_id": "Example String", "code": "Example String", "title": "Example String", "summary": "Example String", "content": "Example String", "status": "Example String", "isPrivate": true, "reactionChoices": [ "Example String" ], "reactionCounts": "Example Custom Scalar", "createdBy": "Example String", "createdUser": { "__typename": "User" }, "createdDate": "Example Custom Scalar", "modifiedBy": "Example String", "modifiedDate": "Example Custom Scalar", "topicId": "Example String", "categoryId": "Example String", "viewCount": 40, "attachments": [ { "__typename": "Attachment" } ], "image": { "__typename": "Attachment" }, "pdfAttachment": { "__typename": "PdfAttachment" }, "publishedUserId": "Example String", "publishedUser": { "__typename": "User" }, "scheduledDate": "Example Custom Scalar", "forms": [ { "__typename": "FormCode" } ] } ], "pagination": { "currentPage": 40, "perPage": 40, "totalCount": 40, "totalPages": 40, "hasNextPage": true, "hasPreviousPage": true } } }
Retrieve a single knowledge base article by ID.
Arguments
Return type
KnowledgeUnique code identifier for programmatic access.
The article title.
Brief summary or excerpt of the article content.
Full article content (HTML).
Publication status: 'draft', 'publish', or 'scheduled'.
Whether this article is only visible to team members.
Available emoji reaction types for this article.
Count of each reaction type received.
User ID of the article creator.
The resolved user who created this article.
When this article was created.
User ID of the last modifier.
When this article was last modified.
The topic this article belongs to.
The category this article belongs to.
Total number of times this article has been viewed.
File attachments included with this article.
Featured image for the article.
PDF attachment with extracted page images.
User ID of who published this article.
The resolved user who published this article.
Scheduled publication date (for status 'scheduled').
Forms embedded in this article.
query knowledgeBaseArticleDetail($_id: String!) {
knowledgeBaseArticleDetail(_id: $_id) {
_id
code
title
summary
content
status
isPrivate
reactionChoices
reactionCounts
createdBy
createdUser {
_id
createdAt
username
email
userPreferences
availability
isActive
details {
__typename
# ...UserDetailsTypeFragment
}
links
status
emailSignatures
groupIds
workspaceIds
isSubscribed
customFieldsData
workspaces {
__typename
# ...WorkspaceFragment
}
isOwner
permissionActions
configs
configsConstants
onboardingHistory {
__typename
# ...OnboardingHistoryFragment
}
departmentIds
departments {
__typename
# ...DepartmentFragment
}
branchIds
branches {
__typename
# ...BranchFragment
}
positionIds
positions {
__typename
# ...PositionFragment
}
score
scoreCategories {
__typename
# ...ScoreCategoriesFragment
}
leaderBoardPosition
employeeId
isOnline
}
createdDate
modifiedBy
modifiedDate
topicId
categoryId
viewCount
attachments {
url
name
type
size
duration
locationData {
__typename
# ...LocationDataFragment
}
}
image {
url
name
type
size
duration
locationData {
__typename
# ...LocationDataFragment
}
}
pdfAttachment {
pdf {
__typename
# ...AttachmentFragment
}
pages {
__typename
# ...AttachmentFragment
}
}
publishedUserId
publishedUser {
_id
createdAt
username
email
userPreferences
availability
isActive
details {
__typename
# ...UserDetailsTypeFragment
}
links
status
emailSignatures
groupIds
workspaceIds
isSubscribed
customFieldsData
workspaces {
__typename
# ...WorkspaceFragment
}
isOwner
permissionActions
configs
configsConstants
onboardingHistory {
__typename
# ...OnboardingHistoryFragment
}
departmentIds
departments {
__typename
# ...DepartmentFragment
}
branchIds
branches {
__typename
# ...BranchFragment
}
positionIds
positions {
__typename
# ...PositionFragment
}
score
scoreCategories {
__typename
# ...ScoreCategoriesFragment
}
leaderBoardPosition
employeeId
isOnline
}
scheduledDate
forms {
workspaceId
formId
}
}
}{ "_id": "Example String" }
{ "data": { "_id": "Example String", "code": "Example String", "title": "Example String", "summary": "Example String", "content": "Example String", "status": "Example String", "isPrivate": true, "reactionChoices": [ "Example String" ], "reactionCounts": "Example Custom Scalar", "createdBy": "Example String", "createdUser": { "_id": "Example String", "createdAt": "Example Custom Scalar", "username": "Example String", "email": "Example String", "userPreferences": "Example Custom Scalar", "availability": "offline", "isActive": true, "details": { "__typename": "UserDetailsType" }, "links": "Example Custom Scalar", "status": "Example String", "emailSignatures": "Example Custom Scalar", "groupIds": [ "Example String" ], "workspaceIds": [ "Example String" ], "isSubscribed": "Example String", "customFieldsData": "Example Custom Scalar", "workspaces": [ { "__typename": "Workspace" } ], "isOwner": true, "permissionActions": "Example Custom Scalar", "configs": "Example Custom Scalar", "configsConstants": [ "Example Custom Scalar" ], "onboardingHistory": { "__typename": "OnboardingHistory" }, "departmentIds": [ "Example String" ], "departments": [ { "__typename": "Department" } ], "branchIds": [ "Example String" ], "branches": [ { "__typename": "Branch" } ], "positionIds": [ "Example String" ], "positions": [ { "__typename": "Position" } ], "score": 40, "scoreCategories": { "__typename": "ScoreCategories" }, "leaderBoardPosition": 40, "employeeId": "Example String", "isOnline": true }, "createdDate": "Example Custom Scalar", "modifiedBy": "Example String", "modifiedDate": "Example Custom Scalar", "topicId": "Example String", "categoryId": "Example String", "viewCount": 40, "attachments": [ { "url": "Example String", "name": "Example String", "type": "Example String", "size": 40, "duration": 40, "locationData": { "__typename": "LocationData" } } ], "image": { "url": "Example String", "name": "Example String", "type": "Example String", "size": 40, "duration": 40, "locationData": { "__typename": "LocationData" } }, "pdfAttachment": { "pdf": { "__typename": "Attachment" }, "pages": [ { "__typename": "Attachment" } ] }, "publishedUserId": "Example String", "publishedUser": { "_id": "Example String", "createdAt": "Example Custom Scalar", "username": "Example String", "email": "Example String", "userPreferences": "Example Custom Scalar", "availability": "offline", "isActive": true, "details": { "__typename": "UserDetailsType" }, "links": "Example Custom Scalar", "status": "Example String", "emailSignatures": "Example Custom Scalar", "groupIds": [ "Example String" ], "workspaceIds": [ "Example String" ], "isSubscribed": "Example String", "customFieldsData": "Example Custom Scalar", "workspaces": [ { "__typename": "Workspace" } ], "isOwner": true, "permissionActions": "Example Custom Scalar", "configs": "Example Custom Scalar", "configsConstants": [ "Example Custom Scalar" ], "onboardingHistory": { "__typename": "OnboardingHistory" }, "departmentIds": [ "Example String" ], "departments": [ { "__typename": "Department" } ], "branchIds": [ "Example String" ], "branches": [ { "__typename": "Branch" } ], "positionIds": [ "Example String" ], "positions": [ { "__typename": "Position" } ], "score": 40, "scoreCategories": { "__typename": "ScoreCategories" }, "leaderBoardPosition": 40, "employeeId": "Example String", "isOnline": true }, "scheduledDate": "Example Custom Scalar", "forms": [ { "workspaceId": "Example String", "formId": "Example String" } ] } }
Return the total number of articles matching the given filters.
Arguments
Return type
IntThe Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
query knowledgeBaseArticlesTotalCount(
$categoryIds: [String]
$codes: [String]
$articleIds: [String]
$topicIds: [String]
$status: String
) {
knowledgeBaseArticlesTotalCount(
categoryIds: $categoryIds
codes: $codes
articleIds: $articleIds
topicIds: $topicIds
status: $status
)
}{ "categoryIds": [ "Example String" ], "codes": [ "Example String" ], "articleIds": [ "Example String" ], "topicIds": [ "Example String" ], "status": "Example String" }
{ "data": 40 }
Perform a semantic search across knowledge base articles using vector similarity.
Arguments
Return type
KnowledgeThe original search query.
Total number of matching results.
The search result hits, ordered by relevance.
Source citations for the results.
query knowledgeBaseSearch(
$query: String!
$kbTopicId: String!
$topK: Int
$filters: JSON
$rerank: Boolean
$rerankMethod: String
$hybridAlpha: Float
) {
knowledgeBaseSearch(
query: $query
kbTopicId: $kbTopicId
topK: $topK
filters: $filters
rerank: $rerank
rerankMethod: $rerankMethod
hybridAlpha: $hybridAlpha
) {
query
totalResults
results {
id
score
metadata
highlight
}
citations
}
}{ "query": "Example String", "kbTopicId": "Example String", "topK": 40, "filters": "Example Custom Scalar", "rerank": true, "rerankMethod": "Example String", "hybridAlpha": 40 }
{ "data": { "query": "Example String", "totalResults": 40, "results": [ { "id": "Example String", "score": 40, "metadata": "Example Custom Scalar", "highlight": "Example String" } ], "citations": [ "Example Custom Scalar" ] } }