Management API

List API Keys

get

Returns all API keys belonging to the authenticated user. Requires a management API key for authentication.

Authorizations

AuthorizationstringRequired

A management API key must be used as the Bearer token.

Responses

200

Successfully returned the list of API keys.

application/json

401

Unauthorized – Missing or invalid token.

application/json

403

Forbidden – The provided API key is not a management key.

application/json

500

Internal server error.

application/json

get

/manage/api-keys

GET /v1/manage/api-keys HTTP/1.1
Host: api.cortecs.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "api_keys": [
    {
      "name": "my-production-key",
      "created_at": 1715100000,
      "is_management_key": false
    },
    {
      "name": "admin-key",
      "created_at": 1715100500,
      "is_management_key": true
    }
  ]
}

Create API Key

post

Creates a new API key for the authenticated user. Requires a management API key for authentication.

Authorizations

AuthorizationstringRequired

A management API key must be used as the Bearer token.

Body

namestringRequired

A unique name for the new API key.

Example: my-new-key

is_management_keybooleanOptional

Whether the new key should have management permissions.

Default: false

Responses

201

API key created successfully. The api_key value is only shown once.

application/json

400

Bad request – Invalid input, duplicate name, or key limit reached.

application/json

401

Unauthorized – Missing or invalid token.

application/json

403

Forbidden – The provided API key is not a management key.

application/json

post

/manage/api-keys

POST /v1/manage/api-keys HTTP/1.1
Host: api.cortecs.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "name": "my-new-key",
  "is_management_key": false
}

{
  "name": "my-new-key",
  "is_management_key": false,
  "api_key": "[API-KEY]"
}

Delete API Key

delete

Deletes an API key by name. Also removes any associated budget configurations. You cannot delete the management key currently being used to authenticate. Requires a management API key for authentication.

Authorizations

AuthorizationstringRequired

A management API key must be used as the Bearer token.

Body

namestringRequired

The name of the API key to delete.

Example: my-old-key

Responses

200

API key deleted successfully.

application/json

successbooleanOptionalExample: true

deletedstringOptional

The name of the deleted key.

400

Bad request – Invalid input or attempting to delete the key in use.

application/json

401

Unauthorized – Missing or invalid token.

application/json

403

Forbidden – The provided API key is not a management key.

application/json

404

Not Found – The specified API key does not exist.

application/json

500

Internal server error.

application/json

delete

/manage/api-keys

DELETE /v1/manage/api-keys HTTP/1.1
Host: api.cortecs.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "name": "my-old-key"
}

{
  "success": true,
  "deleted": "my-old-key"
}

Retrieve Current Project Settings

get

Retrieves the current project settings and configuration details. Requires a management API key for authentication.

Authorizations

AuthorizationstringRequired

A management API key must be used as the Bearer token.

Responses

200

Successfully returned the current project settings.

application/json

_idstringRequired

Unique identifier of the project configuration.

project_idstringRequired

Identifier of the project this configuration belongs to.

allow_overwritebooleanRequired

Allow individual API calls to define their own inference configurations. If disabled, the global settings below will be enforced for all requests.

created_atstring · date-timeRequired

Date and time when this configuration was created.

updated_atstring · date-timeRequired

Date and time when this configuration was last updated.

401

Unauthorized – Missing or invalid token.

application/json

403

Forbidden – The provided API key is not a management key.

application/json

404

Not Found – Project configuration not found.

application/json

500

Internal server error.

get

/manage/project-configs

GET /v1/manage/project-configs HTTP/1.1
Host: api.cortecs.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "_id": "b18d37d09d58d5abc123",
  "project_id": "org_WLH",
  "inference_config": {
    "allowed_providers": [
      "scaleway"
    ],
    "eu_native": false,
    "allow_quantization": true,
    "allow_zero_data_retention": false,
    "enable_model_fallback": true
  },
  "allow_overwrite": false,
  "created_at": "2025-09-26T07:39:03.672Z",
  "updated_at": "2025-09-26T07:39:03.672Z"
}

Update Current Project Settings

put

Updates the current project settings and configuration details. Restricted to project admins. Requires a management API key for authentication.

Authorizations

AuthorizationstringRequired

A management API key must be used as the Bearer token.

Body

A request object for updating the project configuration. Required fields must be included, while other fields are optional. This endpoint is restricted to admins unless allow_overwrite is set to true.

allow_overwriteboolean · nullableOptional

Allow individual API calls to define their own inference configurations. If disabled, the global settings below will be enforced for all requests.

Example: false

created_atstring · date-timeRequired

Timestamp when the configuration was created.

Example: 2025-09-25T08:29:50.735Z

updated_atstring · date-timeRequired

Timestamp when the configuration was last updated.

Example: 2025-09-25T08:29:50.735Z

Responses

200

Project configuration updated successfully.

application/json

Indicates whether the operation was successful.

successbooleanOptionalExample: true

400

Bad Request – Invalid configuration or registry validation failed.

application/json

401

Unauthorized – Missing or invalid token.

application/json

403

Forbidden – Not a management key or user is not an admin.

application/json

404

Not Found – Project configuration not found.

application/json

500

Internal server error.

put

/manage/project-configs

PUT /v1/manage/project-configs HTTP/1.1
Host: api.cortecs.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 297

{
  "inference_config": {
    "allowed_providers": [
      "mistral",
      "scaleway"
    ],
    "preference": "speed",
    "eu_native": false,
    "allow_quantization": true,
    "allow_zero_data_retention": false,
    "enable_model_fallback": true
  },
  "allow_overwrite": false,
  "created_at": "2025-09-25T08:29:50.735Z",
  "updated_at": "2025-09-25T08:29:50.735Z"
}

{
  "success": true
}

Retrieve User Balance

get

Retrieves the current balance information of the authenticated user. Requires a management API key for authentication.

Authorizations

AuthorizationstringRequired

A management API key must be used as the Bearer token.

Responses

200

Successfully retrieved user balance.

application/json

current_balancenumber · floatOptional

The current balance of the user.

Example: 1234.56

currencystringOptional

The currency in which the balance is expressed.

Example: EUR

401

Unauthorized – Missing or invalid token.

application/json

403

Forbidden – The provided API key is not a management key.

application/json

500

Internal server error.

get

/manage/users/balance

GET /v1/manage/users/balance HTTP/1.1
Host: api.cortecs.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "current_balance": 1234.56,
  "currency": "EUR"
}

PreviousAnthropic Messages [BETA]NextSecurity & Compliance

Last updated 25 days ago