API Keys

Use these operations to interact with API keys in Cortex.

Required permissions

Your API token must have the Edit API keys permission.

Operations

List API keys

get

List API keys

The API key used to make the request must have the Edit API keys permission

Authorizations

Query parameters

pageSizeinteger · int32Required

Number of results to return per page, between 1 and 1000. Default 250.

Default: 250

pageinteger · int32Required

Page number to return, 0-indexed. Default 0.

Default: 0

Responses

200

Successfully found API keys

application/jsonapplication/yaml

400

Bad request

application/jsonapplication/yaml

429

The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.

application/problem+json

get

HTTPcURLJavaScriptPython

GET /api/v1/auth/key HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Accept: */*

{
  "apiKeys": [
    {
      "cid": "ak1234567890abcdef",
      "createdDate": "2025-01-15T22:47:30Z",
      "description": "API Key used for entities scanner script",
      "expirationDate": "2025-06-28T19:24:16.414Z",
      "last4": "0kAg",
      "name": "Entities scanner",
      "roles": [
        {
          "role": "READ_ONLY",
          "type": "text"
        }
      ]
    }
  ],
  "page": 1,
  "total": 1,
  "totalPages": 1
}

Get API key

get

Get API key

Authorizations

Path parameters

cidstringRequired

The unique, auto-generated identifier for the API key

Example: ak1234567890abcdef

Responses

200

Successfully found API key

application/jsonapplication/yaml

400

Bad request

application/jsonapplication/yaml

404

API key not found

application/jsonapplication/yaml

429

The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.

application/problem+json

get

HTTPcURLJavaScriptPython

GET /api/v1/auth/key/{cid} HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Accept: */*

{
  "cid": "ak1234567890abcdef",
  "createdDate": "2025-01-15T22:47:30Z",
  "description": "API Key used for entities scanner script",
  "expirationDate": "2025-06-28T19:24:16.414Z",
  "last4": "0kAg",
  "name": "Entities scanner",
  "roles": [
    {
      "role": "READ_ONLY",
      "type": "text"
    }
  ]
}

Create API key

post

Create new API key.

The API key used to make the request must have the Edit API keys permission

Authorizations

Body

application/jsonapplication/yaml

descriptionstringOptional

Description of the API key

Example: API Key used for entities scanner script

expirationDatestring · date-timeOptional

Expiration date of the API key. Format: ISO8601 with timezone offset

namestringRequired

Name of the API key

Example: Entities scanner

Responses

200

Successfully created API key

application/jsonapplication/yaml

400

Bad request

application/jsonapplication/yaml

403

Access denied

application/jsonapplication/yaml

429

The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.

application/problem+json

post

HTTPcURLJavaScriptPython

POST /api/v1/auth/key HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 173

{
  "description": "API Key used for entities scanner script",
  "expirationDate": "2025-06-28T19:24:16.414Z",
  "name": "Entities scanner",
  "roles": [
    {
      "role": "READ_ONLY",
      "type": "text"
    }
  ]
}

application/jsonapplication/yaml

{
  "apiKey": "3WpQ3WpQ3WpQ3WpQ",
  "description": "API Key used for entities scanner script",
  "expirationDate": "2025-06-28T19:24:16.414Z",
  "name": "Entities scanner",
  "roles": [
    {
      "role": "READ_ONLY",
      "type": "text"
    }
  ]
}

Update API key

put

Update API key

The API key used to make the request must have the Edit API keys permission

Authorizations

Path parameters

cidstringRequired

The unique, auto-generated identifier for the API key

Example: ak1234567890abcdef

Body

application/jsonapplication/yaml

descriptionstringOptional

Description of the API key

Example: API Key used for entities scanner script

namestringRequired

Name of the API key

Example: Entities scanner

Responses

200

Successfully updated API key

application/jsonapplication/yaml

400

Bad request

application/jsonapplication/yaml

403

Access denied

application/jsonapplication/yaml

404

API key not found

application/jsonapplication/yaml

429

The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.

application/problem+json

put

HTTPcURLJavaScriptPython

PUT /api/v1/auth/key/{cid} HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 84

{
  "description": "API Key used for entities scanner script",
  "name": "Entities scanner"
}

application/jsonapplication/yaml

{
  "cid": "ak1234567890abcdef",
  "createdDate": "2025-01-15T22:47:30Z",
  "description": "API Key used for entities scanner script",
  "expirationDate": "2025-06-28T19:24:16.414Z",
  "last4": "0kAg",
  "name": "Entities scanner",
  "roles": [
    {
      "role": "READ_ONLY",
      "type": "text"
    }
  ]
}

Delete API key

delete

Delete API key

The API key used to make the request must have the Edit API keys permission

Authorizations

Path parameters

cidstringRequired

The unique, auto-generated identifier for the API key

Example: ak1234567890abcdef

Responses

200

Successfully deleted API key

400

Bad request

application/jsonapplication/yaml

403

Access denied

application/jsonapplication/yaml

404

API key not found

application/jsonapplication/yaml

429

The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.

application/problem+json

delete

HTTPcURLJavaScriptPython

DELETE /api/v1/auth/key/{cid} HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Accept: */*

No content