Discovery Audit

Use these operations to interact with the discovered entities list in Cortex.

Required permissions

Your API key must have the Configure discovery audit events permission.

Operations

Retrieve discovery audit report

get

This report shows you recent changes in your environment that aren't reflected in Cortex, including newly created repositories, services, and resources that we discover from your integrations or which were deleted in the environment but corresponding Cortex entities are still present.

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

typestring · enumOptional

Filter based on type of the event

Possible values:

sourcestring · enumOptional

Filter based on integration source

Possible values:

includeIgnoredbooleanOptional

Flag to include ignored events in result

Default: false

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 retrieved discovery audit report

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/discovery-audit

HTTPcURLJavaScriptPython

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

{
  "events": [
    {
      "entity": {
        "description": "text",
        "name": "My Favorite Entity",
        "tag": "my-favorite-entity",
        "type": "service"
      },
      "isIgnored": true,
      "mappingKey": {
        "type": "AWS",
        "arn": "arn"
      },
      "source": "AWS",
      "type": "NEW_REPOSITORY"
    }
  ],
  "page": 1,
  "total": 1,
  "totalPages": 1
}