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 read access to contacts, conversations, tickets, calls, escalations, and workspace metadata. 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