REST API

Access your Connic project programmatically with API keys. Trigger agents, query runs, manage knowledge, and pull cost data from your own applications or CI/CD pipelines.

Overview

Connic exposes a REST API that lets you interact with your project outside of the dashboard. Use it to trigger agent runs from your backend, pull run results into external monitoring, manage your knowledge base programmatically, or query cost data for billing dashboards.

All API requests are authenticated with project-scoped API keys and rate-limited per project. The full interactive reference with request/response schemas and a built-in client is available at the API Reference .

Authentication

API requests are authenticated using API keys. Each key is scoped to a single project and can only access endpoints within that project. Pass the key as a Bearer token in the Authorization header:

Authorization: Bearer cnc_your_api_key

Create and manage API keys in Project Settings → CLI / API Keys. Keys start with the cnc_ prefix and are shown only once when created. Store them securely.

API Key Permissions

Each API key can be configured with granular permissions that control which API sections it can access and whether it can read, write, or both. Permissions are set when creating a key and displayed in the key list.

Rate Limiting

API requests are rate-limited to 60 requests per minute per project. All API keys belonging to the same project share a single rate limit bucket. When the limit is exceeded, the API responds with:

If you need higher limits, contact the Connic team.

Quick Examples

curl -X POST https://api.connic.co/v1/projects/{project_id}/agents/{agent_name}/trigger \
  -H "Authorization: Bearer cnc_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"message": "Summarize the latest sales report"}'

curl https://api.connic.co/v1/projects/{project_id}/runs/{run_id} \
  -H "Authorization: Bearer cnc_your_api_key"

curl -X POST "https://api.connic.co/v1/projects/{project_id}/knowledge/text?environment_id={env_id}" \
  -H "Authorization: Bearer cnc_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Your document text here...",
    "namespace": "docs.api",
    "entry_id": "my-custom-id"
  }'

Error Responses

The API uses standard HTTP status codes. Error responses include a JSON body with a detail field describing the issue.