Management API
The endpoints an OAuth access token can call: organization, projects, API keys and usage.
Base URL: https://api.cencori.com/v1
Every request carries the access token:
-H "Authorization: Bearer $ACCESS_TOKEN"The token decides the organization. There is no organization ID in any path.
Each authorization can make 120 requests a minute.
Get the organization
curl https://api.cencori.com/v1/organization \
-H "Authorization: Bearer $ACCESS_TOKEN"{
"id": "0b6f…",
"object": "organization",
"name": "Acme",
"slug": "acme",
"plan": "pro",
"member_count": 4,
"created_at": "2026-03-02T10:14:00Z"
}Get usage
curl "https://api.cencori.com/v1/organization/usage?range=30d" \
-H "Authorization: Bearer $ACCESS_TOKEN"How far back you can read follows the organization's plan: 7 days on Free, 30 on Pro, 90 on Enterprise. A longer range is shortened to the plan's limit, and the response says which range was used.
{
"object": "usage",
"range": "30d",
"project_id": null,
"requests": 18422,
"successful_requests": 18310,
"input_tokens": 9120044,
"output_tokens": 2204190,
"total_tokens": 11324234,
"cost_usd": 41.87,
"average_latency_ms": 912,
"by_model": { "gpt-5.6": 12010, "claude-sonnet-5": 6412 },
"by_provider": { "openai": 12010, "anthropic": 6412 }
}by_model and by_provider count requests. For daily records by project, model and customer, use the usage export.
List projects
curl https://api.cencori.com/v1/projects \
-H "Authorization: Bearer $ACCESS_TOKEN"{
"object": "list",
"data": [
{
"id": "5d1c…",
"object": "project",
"name": "Storefront",
"slug": "storefront",
"description": null,
"region": "af-south-1",
"status": "active",
"created_at": "2026-11-19T09:30:00Z"
}
]
}Projects are returned oldest first.
Create a project
curl https://api.cencori.com/v1/projects \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "Storefront", "description": "Created by Acme Deploy"}'Returns 201 with the project. The slug is made from the name; if it is taken in the organization, a number is added (storefront-2).
The organization's plan applies. The Free plan includes one project, so a second create returns 402 with the code project_limit_reached. Tell the user their organization needs Pro; your app cannot upgrade it.
Get a project
curl https://api.cencori.com/v1/projects/$PROJECT_ID \
-H "Authorization: Bearer $ACCESS_TOKEN"Returns the project, or 404 with project_not_found. A project in another organization is also 404.
Update a project
curl -X PATCH https://api.cencori.com/v1/projects/$PROJECT_ID \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "Storefront (production)"}'Send name, description or both. description: null clears it. The slug does not change when the name does.
List API keys
curl https://api.cencori.com/v1/projects/$PROJECT_ID/api-keys \
-H "Authorization: Bearer $ACCESS_TOKEN"{
"object": "list",
"data": [
{
"id": "a41e…",
"object": "api_key",
"name": "Acme Deploy",
"key_prefix": "csk_9f2c...",
"environment": "production",
"type": "secret",
"allowed_domains": null,
"created_at": "2026-11-19T09:31:00Z",
"last_used_at": null
}
]
}Revoked keys are not listed. A key's value is never returned here.
Create an API key
curl https://api.cencori.com/v1/projects/$PROJECT_ID/api-keys \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "Acme Deploy"}'Returns 201 with the key object plus key, the key's value:
{
"id": "a41e…",
"object": "api_key",
"name": "Acme Deploy",
"key_prefix": "csk_9f2c...",
"environment": "production",
"type": "secret",
"allowed_domains": null,
"created_at": "2026-11-19T09:31:00Z",
"last_used_at": null,
"key": "csk_9f2c…"
}key is returned once. Cencori stores only a hash and cannot show it again. Store it where the user's app will read it, then use it with the AI API.
A project can have 50 active keys.
Revoke an API key
curl -X DELETE https://api.cencori.com/v1/projects/$PROJECT_ID/api-keys/$KEY_ID \
-H "Authorization: Bearer $ACCESS_TOKEN"{ "id": "a41e…", "object": "api_key", "revoked": true }The key stops working at once and cannot be restored.
Errors
Errors use the same envelope as the rest of the Cencori API:
{
"error": {
"type": "permission_error",
"code": "insufficient_scope",
"message": "This token does not have the projects:write permission.",
"request_id": "req_1a2b3c4d"
}
}Everything your app creates, changes or revokes is recorded in the organization's audit log under your app's name.

