​
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
Go to the API Keys page and create a new 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.
StatusDescription
200Successful request.
400Check that the parameters were correct.
401Check that the API key is correct.
404The resource was not found.
429The rate limit was exceeded.
5xxIndicates 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.
We are working on a more flexible rate limit system.