Skip to content

GraphQL Overview

Browse queries, mutations, and types in the schema reference. For authentication, endpoint URLs, and domain guides, see the API Overview.

Conversations & messaging

Queries

Overview

Mutations

Overview

Objects

Overview

Enums

Overview
Contacts & CRM

Queries

Overview

Mutations

Overview

Objects

Overview

Inputs

Overview
Products & commerce

Queries

Overview

Mutations

Overview

Objects

Overview
Apps & credentials

Queries

Overview

Mutations

Overview

Objects

Overview
Organization

Queries

Overview

Objects

Overview

Enums

Overview
Other

Queries

Overview

Mutations

Overview

Objects

Overview

KnowledgeBaseCategoriesPaginated

Paginated list of knowledge base categories.

The list of categories for the current page.

pagination

Pagination metadata.

Sample
{ "data": [ { "__typename": "KnowledgeBaseCategory" } ], "pagination": { "__typename": "PaginationInfo" } }

KnowledgeBaseCategory

A category that groups related knowledge base articles together. Categories can be nested under parent categories for hierarchical organization.

_id
String
code
String

Unique code identifier for programmatic access.

title
String

The category title.

description
String

Description of what this category covers.

Articles in this category, optionally filtered by status.

status
icon
String

Icon identifier for the category.

createdBy
String

User ID of the category creator.

createdDate

When this category was created.

modifiedBy
String

User ID of the last modifier.

modifiedDate

When this category was last modified.

parentCategoryId
String

Parent category ID for nested categorization.

The first topic this category belongs to.

authors

Users who have authored articles in this category.

numOfArticles
Float

Count of articles in this category, optionally filtered by status.

status
countArticles
Int

Total article count in this category.

Sample
{ "_id": "Example String", "code": "Example String", "title": "Example String", "description": "Example String", "articles": [ { "__typename": "KnowledgeBaseArticle" } ], "icon": "Example String", "createdBy": "Example String", "createdDate": "Example Custom Scalar", "modifiedBy": "Example String", "modifiedDate": "Example Custom Scalar", "parentCategoryId": "Example String", "firstTopic": { "__typename": "KnowledgeBaseTopic" }, "authors": [ { "__typename": "User" } ], "numOfArticles": 40, "countArticles": 40 }

KnowledgeBaseParentCategory

A category with its nested child categories included.

_id
String
code
String

Unique code identifier.

title
String

The category title.

description
String

Description of what this category covers.

Articles directly in this parent category.

icon
String

Icon identifier.

createdBy
String

User ID of the creator.

createdDate

When this category was created.

modifiedBy
String

User ID of the last modifier.

modifiedDate

When this category was last modified.

parentCategoryId
String

Parent category ID (for deeper nesting).

The first topic this category belongs to.

authors

Users who have authored articles in this category.

numOfArticles
Float

Count of articles, optionally filtered by status.

status

Nested child categories.

Sample
{ "_id": "Example String", "code": "Example String", "title": "Example String", "description": "Example String", "articles": [ { "__typename": "KnowledgeBaseArticle" } ], "icon": "Example String", "createdBy": "Example String", "createdDate": "Example Custom Scalar", "modifiedBy": "Example String", "modifiedDate": "Example Custom Scalar", "parentCategoryId": "Example String", "firstTopic": { "__typename": "KnowledgeBaseTopic" }, "authors": [ { "__typename": "User" } ], "numOfArticles": 40, "childrens": [ { "__typename": "KnowledgeBaseCategory" } ] }

KnowledgeBaseSearchHit

A single search result hit from the knowledge base vector search.

id
String!,non-null

The article ID that matched.

score
Float

Relevance score (higher is better).

metadata

Additional metadata about the match.

highlight
String

Highlighted text snippet showing the matching content.

Sample
{ "id": "Example String", "score": 40, "metadata": "Example Custom Scalar", "highlight": "Example String" }

KnowledgeBaseSearchResult

Results from a knowledge base semantic search query.

query
String!,non-null

The original search query.

totalResults
Int!,non-null

Total number of matching results.

The search result hits, ordered by relevance.

citations
[JSON!],non-null

Source citations for the results.

Sample
{ "query": "Example String", "totalResults": 40, "results": [ { "__typename": "KnowledgeBaseSearchHit" } ], "citations": [ "Example Custom Scalar" ] }

KnowledgeBaseTopic

A knowledge base topic — the top-level organizational unit. Topics are associated with a brand and contain categories of articles. They can be styled with custom colors and background images.

_id
String!,non-null
code
String

Unique code identifier for programmatic access.

title
String

The topic title.

description
String

Description of the topic.

Categories within this topic.

workspace
color
String
backgroundImage
String

URL of the background image for the topic page.

languageCode
String

ISO language code for the topic content (e.g. 'en', 'ar').

createdBy
String

User ID of the topic creator.

createdDate

When this topic was created.

modifiedBy
String

User ID of the last modifier.

modifiedDate

When this topic was last modified.

Top-level parent categories within this topic.

Sample
{ "_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" } ] }

KnowledgeBaseTopicsPaginated

Paginated list of knowledge base topics.

The list of topics for the current page.

pagination

Pagination metadata.

Sample
{ "data": [ { "__typename": "KnowledgeBaseTopic" } ], "pagination": { "__typename": "PaginationInfo" } }

LeadStageHistoryEntry

Single entry in a lead's stage-change history.

stageCode
String!,non-null
at
Date!,non-null
byUserId
String
note
String
Sample
{ "stageCode": "Example String", "at": "Example Custom Scalar", "byUserId": "Example String", "note": "Example String" }

LocationData

latitude
Float
longitude
Float
name
String
address
String
Sample
{ "latitude": 40, "longitude": 40, "name": "Example String", "address": "Example String" }

LocationOption

lat
Float
lng
Float
description
String
Sample
{ "lat": 40, "lng": 40, "description": "Example String" }
Referenced in

Logic

fieldId
String!,non-null
logicOperator
String
logicValue
Sample
{ "fieldId": "Example String", "logicOperator": "Example String", "logicValue": "Example Custom Scalar" }

Unions

Overview

Enums

Overview

Inputs

Overview

Scalars

Overview