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

Query parameters

startTimestring · date-timeoptional

endTimestring · date-timeoptional

pageinteger · int32 · default: 0required

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

pageSizeinteger · int32 · default: 250required

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

actionsstring · enum[]optional

objectIdentifiersstring[]optional

objectTypesstring · enumoptional

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

Options: CATALOG, TEAM, AWS_CONFIGURATION, BITBUCKET_CONFIGURATION

actorTypesstring · enum[]optional

actorApiKeyIdentifiersstring[]optional

actorEmailsstring[]optional

actorIpAddressesstring[]optional

actorRequestTypesstring · enumoptional

Options: API_KEY_ENTITY, ATLASSIAN_WEBHOOK, SCORECARD_BADGES, SLACK_COMMAND

Responses

application/json

application/problem+json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.getcortexapp.com/api/v1/audit-logs?page=1&pageSize=1' \
  --header 'Authorization: Bearer JWT'

200

429

200

{
  "logs": [
    {
      "action": "CREATE",
      "actorIdentifier": "text",
      "ipAddress": "text",
      "objectIdentifier": "text",
      "objectType": "text",
      "timestamp": "2025-03-29T00:54:19.921Z"
    }
  ],
  "page": 1,
  "total": 1,
  "totalPages": 1
}

Successfully retrieved audit logs