Skip to navigation

API integration

View as Markdown

The Conduit REST API provides programmatic access to all platform capabilities, including search, workflow orchestration, document management, and review.

Authentication

All API requests require a Bearer token:

curl -H "Authorization: Bearer $CONDUIT_API_KEY" \
https://api.conductorai.com/v1/health

API keys are scoped to an organization and can be restricted by permission level.

Base URL

EnvironmentBase URL
Productionhttps://api.conductorai.com/v1
Staginghttps://api-staging.conductorai.com/v1

Core endpoints

Documents

# Upload a document
POST /v1/documents
# List documents in a collection
GET /v1/documents?collection=my-collection
# Get document metadata
GET /v1/documents/{document_id}
# Delete a document
DELETE /v1/documents/{document_id}
# Run a search query
POST /v1/search
# Get search results by ID
GET /v1/search/{search_id}

Workflows

# List available workflows
GET /v1/workflows
# Run a workflow
POST /v1/workflows/run
# Get workflow run status
GET /v1/workflows/runs/{run_id}
# Cancel a workflow run
POST /v1/workflows/runs/{run_id}/cancel

Rate limits

TierRequests/minuteConcurrent workflows
Standard1005
Professional50025
EnterpriseCustomCustom

SDKs

from conductorai import ConduitClient
client = ConduitClient(api_key="your-api-key")
# Search documents
results = client.search(
query="export control policy updates",
mode="agentic"
)
for result in results:
print(f"{result.document}: {result.content}")