Discovery Audit

Use these operations to interact with the Discovery audit 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

Options: NEW_REPOSITORY, REPOSITORY_DELETED, REPOSITORY_ARCHIVED, NEW_K8S_RESOURCE, NEW_APM_RESOURCE, APM_RESOURCE_NOT_DETECTED, NEW_ECS_RESOURCE, ECS_RESOURCE_NOT_DETECTED, NEW_AWS_RESOURCE, AWS_RESOURCE_NOT_DETECTED, NEW_GOOGLE_CLOUD_RESOURCE, GOOGLE_CLOUD_RESOURCE_NOT_DETECTED, NEW_AZURE_RESOURCE, AZURE_RESOURCE_NOT_DETECTED

sourcestring · enumoptional

Filter based on integration source

Options: AWS, AZURE_DEVOPS, AZURE_RESOURCES, BITBUCKET, DATADOG, DYNATRACE, ECS, GCP, GITHUB, GITLAB, INSTANA, K8S, LIGHTSTEP, LAMBDA, LAMBDA_CLOUD_CONTROL, NEWRELIC, SERVICENOW, SERVICENOW_DOMAIN

includeIgnoredboolean · default: falseoptional

Flag to include ignored events in result

pageSizeinteger · int32 · default: 250required

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

pageinteger · int32 · default: 0required

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

Responses

application/json

application/problem+json

cURL

JavaScript

Python

HTTP

cURL

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

200

429

200

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

Successfully retrieved discovery audit report