Introduction
Understand general concepts, response codes, and authentication strategies.
- App (Organization) API: Manage your organization-level settings and configurations, including retrieving organization data, API keys, creating collections and workflows, managing files, members, and more.
- Collections API: Retrieve collections, create records, manage collections, and handle collection triggers and more.
- Records API: Retrieve records, manage records, configure and manage rules, and more.
- Workflows API: Retrieve workflows, manage workflows, conduct workflow tests, run workflows, and more.
- Webhooks API: Get real-time logs, update webhooks, delete webhooks, and more.
Base URL
The Cortex API is built on REST principles. We enforce HTTPS in every request to improve data security, integrity, and privacy. The API does not support HTTP.
All requests contain the following base URL:
https://api.withcortex.ai
Authentication
To authenticate, you need to add an Authorization header with the contents being Bearer YOUR_API_KEY
.
Authorization: Bearer YOUR_API_KEY
Response codes
Cortex uses standard HTTP codes to indicate the success or failure of your requests.
In general, 2xx
HTTP codes correspond to success, 4xx
codes are for user-related failures, and 5xx
codes are for infrastructure issues.
Status | Description |
---|---|
200 | Successful request. |
400 | Check that the parameters were correct. |
401 | Check that the API key is correct. |
404 | The resource was not found. |
429 | The rate limit was exceeded. |
5xx | Indicates an error with Cortex servers. |
Rate limits
Cortex enforces rate limits to ensure fair usage of the API. If you exceed the rate limit, you will receive a 429
status code.
The rate limit is currently set at 500 requests per minute per IP address.
Was this page helpful?