Skip to main content
​
API
Discussion status is now OPEN or RESOLVED. Agent activity moved to agentStatus (UNKNOWN, IDLE, and related values). If you filter or switch on the old discussion status values (IDLE, IN_PROGRESS, APPROVAL_REQUESTED), update those clients.Discussions
​
API
Added isCustomAgent on MachineUser. true when the machine user is an agent the workspace built itself, rather than an ordinary API integration.Machine users
​
Webhooks
2026-07-14
  • Added thread.note_mention_created when a note mentions a machine user (for example an agent). Payload includes thread, note, and mentions (an array of machineUser).
  • Added attio and email_domain to tenant.source on thread.tenant_updated.
Webhook versions · JSON schema
​
API
Added createTenant. It fails if a tenant already exists with the given externalId. Use upsertTenant when you want create-or-update. Requires tenant:create.
​
API
  • Added threadsByExternalId to list every thread with a given externalId, across customers. threadByExternalId still returns a single thread for one customer.
  • Added knowledgeSourceCitationsByThread for the knowledge sources cited by AI replies on a thread.
Fetch threads · Searching knowledge
​
API
Added updateThreadExternalId. Pass externalId: null to clear it. Requires thread:edit.Updating threads
​
Webhooks
2026-06-15
  • Added WAITING_INDEFINITELY to statusDetail.type on thread (snoozed with no duration). The same value is available on the thread type in the API.
  • componentUser.user may be a machineUser as well as a user when a UI component references a machine user.
Webhook versions · JSON schema
​
API
Added importThread and importThreadMessages for backfilling historical threads without firing SLAs or autoresponders. Each externalId is idempotent (NOOP on replay). Requires thread:import.Importing threads
​
Webhooks
2026-05-06
  • Added numberValue on threadField.
  • Added NUMBER to threadField.type.
Webhook versions · JSON schema
​
API
Added a paginated discussions query with filters for user and discussion type.Fetch discussions
​
API
Added webhookDeliveryAttempts so you can inspect delivery attempts, including response status and body, without leaving the API.Delivery attempts
​
API
Added createDiscussion, sendDiscussionMessage, and the single discussion query, so you can open a side-conversation on a thread and post into it programmatically.Create a discussion · Send a message
​
API
Added importCustomers, importTenants, and importTenantFieldSchemas for bulk backfills from another system. Each is idempotent on externalId and returns added, updated, and skipped counts.
​
API
Added updateNote for editing an existing note on a thread.Notes
​
API
Added lockThread to freeze a thread so non-admin users cannot reply or make changes.
​
API
Added updateThreadAgentStatus to set a thread’s AI agent status to IN_PROGRESS, HANDED_OFF, or HANDLED.Building agents
​
API
Tasks are now available over the API: createTask, updateTask, deleteTask, plus task, taskByRef, and a filterable tasks query.Tasks
​
API
Added labelTypeByExternalId, so you can look up a label type by the ID it has in your own system.Label types
​
API
Added deleteThread for permanently deleting a thread.Deleting threads
​
API
Added searchKnowledgeSources to search the knowledge your agents draw on.Searching knowledge
​
API
Added upsertTenantField, deleteTenantField, and deleteTenantFieldSchema, completing tenant field management over the API.Tenant fields
​
API
Added the tenantFieldSchemas query and upsertTenantFieldSchema mutation, including field visibility.Tenant fields
​
API
Added deleteTenant. Deleting a tenant unlinks it from all customers and removes its fields.Deleting tenants
​
API
Added the knowledgeSources query and deleteKnowledgeSource mutation.Searching knowledge
​
Webhooks
2025-08-06
  • Added additionalAssignees on thread.
  • Added externalId and isExcludedFromAi on labelType.
Webhook versions · JSON schema