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

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

get

HTTPcURLJavaScriptPython

GET /api/v1/discovery-audit HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
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
}