Skip to main content
The Conduit API is only available on the v3 plan. Contact support@conduit.ai to enable API access for your workspace.

​
Overview

The Conduit API gives you programmatic access to contacts, conversations, tickets, calls, escalations, custom attributes, knowledge base, and workspace metadata. Read and write endpoints are available depending on your token’s access level. All endpoints are REST-based and return JSON. Base URL 
https://api.conduit.ai/v1

​
Authentication

All requests require a Bearer token in the Authorization header. Generate API tokens from Settings > API Tokens in your Conduit workspace. 
curl https://api.conduit.ai/v1/workspaces \
  -H "Authorization: Bearer YOUR_API_TOKEN"
Tokens are scoped to one or more workspaces. Use the List Workspaces endpoint to discover which workspaces your token can access.

​
Pagination

List endpoints return paginated results. Use limit (1-100, default 20) and cursor to page through results. 
{
  "data": [...],
  "next_cursor": "page-token",
  "has_more": true
}
Pass next_cursor as the cursor query parameter in your next request to fetch the next page. When has_more is false, you’ve reached the end.

​
Rate Limits

API requests are rate-limited per workspace. If you exceed the limit, the API returns 429 Too Many Requests with a Retry-After header indicating when you can retry.

​
Errors

All errors return a JSON object with an error field: 
{
  "error": "Invalid workspace id"
}
StatusMeaning
400Invalid request parameters
401Missing or invalid API token
403Token does not have access to the requested workspace
404Resource not found
429Rate limit exceeded