Skip to main content
The REST API is for custom integrations that cannot use MCP. For AI agents, use MCP instead.

Base URL

https://api.correl8.ai

Authentication

Project API keys from Settings. Send as:
Authorization: ApiKey c8.xxx
X-Api-Key: c8.xxx
Keys are scoped to a single project — a key for project A returns 404 on project B.

Endpoints

MethodPathDescription
POST/v1/project/{project_id}/observations/Create one or more observations

Free tier limits

1,000 processed observations per month per workspace. When the limit is reached, Correl8 keeps ingesting but does not process — posts return 201 with processing_status: billing_blocked. Check usage in Settings.

Error responses

StatusMeaning
400Validation error
401Missing or invalid API key
404Project not found, or key not authorized