Audit Logs

Use these operations to interact with audit logs in Cortex.

Required permissions

Your API token must have the View audit logs permission.

Retrieve audit logs

get

Note: To see the complete list of possible values, please reference the available filter options for audit logs under Settings in the app. API key must have the View audit logs permission.

Authorizations

bearerAuth

AuthorizationstringRequired

All requests to the Cortex API need to provide an Authorization: Bearer <token> header, where <token> is an API key created in the Settings page of your workspace.

Query parameters

startTimestring · date-timeOptional

endTimestring · date-timeOptional

pageinteger · int32Required

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

Default: 0

pageSizeinteger · int32Required

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

Default: 250

objectIdentifiersstring[]Optional

objectTypesstring · enumOptional

Filter by Cortex object types (CATALOG, SERVICE, TEAM, SCORECARD, etc), integration configurations (AWS_CONFIGURATION, BITBUCKET_CONFIGURATION, etc), and more.

Possible values:

actorApiKeyIdentifiersstring[]Optional

actorEmailsstring[]Optional

actorIpAddressesstring[]Optional

actorRequestTypesstring · enumOptionalPossible values:

Responses

200

Successfully retrieved audit logs

application/json

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

/api/v1/audit-logs

HTTPcURLJavaScriptPython

GET /api/v1/audit-logs?page=0&pageSize=250 HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "logs": [
    {
      "action": "CREATE",
      "actorIdentifier": "text",
      "ipAddress": "text",
      "objectIdentifier": "text",
      "objectType": "text",
      "timestamp": "2026-01-20T20:05:42.935Z"
    }
  ],
  "page": 1,
  "total": 1,
  "totalPages": 1
}