# Discovery Audit

Use these operations to interact with the [discovered entities list](/ingesting-data-into-cortex/entities-overview/entities/discovery-audit.md) in Cortex.

### Required permissions

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

## Operations

## Retrieve discovery audit report

> 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.

```json
{"openapi":"3.0.1","info":{"title":"Cortex API","version":"v1"},"tags":[{"name":"Discovery Audit"}],"servers":[{"url":"https://api.getcortexapp.com","description":"Cortex Cloud API host"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"bearerFormat":"JWT","description":"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.","scheme":"bearer","type":"http"}},"schemas":{"DiscoveryAuditReportResponse":{"required":["events","page","total","totalPages"],"type":"object","properties":{"events":{"type":"array","items":{"$ref":"#/components/schemas/DiscoveryAuditEvent"}},"page":{"type":"integer","description":"Current page number, 0-indexed","format":"int32"},"total":{"type":"integer","description":"Total number of results","format":"int32"},"totalPages":{"type":"integer","description":"Total number of pages","format":"int32"}}},"DiscoveryAuditEvent":{"required":["isIgnored","mappingKey","source","type"],"type":"object","properties":{"entity":{"$ref":"#/components/schemas/CortexEntity"},"isIgnored":{"type":"boolean","description":"Specifies whether discovered event is marked as ignored"},"mappingKey":{"$ref":"#/components/schemas/EntityDiscoveryKey"},"source":{"type":"string","description":"Integration source","enum":["AWS","AZURE_DEVOPS","AZURE_RESOURCES","BITBUCKET","DATADOG","DYNATRACE","ECS","GCP","GITHUB","GITLAB","INSTANA","K8S","LIGHTSTEP","LAMBDA","LAMBDA_CLOUD_CONTROL","NEWRELIC","SERVICENOW","SERVICENOW_DOMAIN"]},"type":{"type":"string","description":"Type of the event","enum":["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"]}}},"CortexEntity":{"required":["name","tag","type"],"type":"object","properties":{"description":{"type":"string","description":"Description of the entity visible in the catalog. This may contain markdown."},"name":{"type":"string","description":"Human-readable name for the entity"},"tag":{"type":"string","description":"Unique identifier for the entity. Corresponds to the x-cortex-tag field in the entity descriptor."},"type":{"type":"string","description":"Type of the entity. Corresponds to the x-cortex-type field in the entity descriptor or 'service' for services."}},"description":"Related Cortex entity"},"EntityDiscoveryKey":{"required":["type"],"type":"object","properties":{"type":{"type":"string"}},"description":"Mapping key of the event. Its schema is dependent on the source","discriminator":{"propertyName":"type"},"oneOf":[{"$ref":"#/components/schemas/AWS"},{"$ref":"#/components/schemas/AZURE_DEVOPS"},{"$ref":"#/components/schemas/AZURE_RESOURCES"},{"$ref":"#/components/schemas/BITBUCKET"},{"$ref":"#/components/schemas/DATADOG"},{"$ref":"#/components/schemas/DYNATRACE"},{"$ref":"#/components/schemas/ECS"},{"$ref":"#/components/schemas/GCP"},{"$ref":"#/components/schemas/GITHUB"},{"$ref":"#/components/schemas/GITLAB"},{"$ref":"#/components/schemas/INSTANA"},{"$ref":"#/components/schemas/K8S"},{"$ref":"#/components/schemas/LAMBDA"},{"$ref":"#/components/schemas/LIGHTSTEP"},{"$ref":"#/components/schemas/NEWRELIC"},{"$ref":"#/components/schemas/SERVICENOW"}]},"AWS":{"required":["type"],"type":"object","discriminator":{"propertyName":"type"},"allOf":[{"$ref":"#/components/schemas/EntityDiscoveryKey"},{"type":"object","properties":{"type":{"type":"string"}}}]},"AZURE_DEVOPS":{"required":["projectName","repoName"],"type":"object","allOf":[{"$ref":"#/components/schemas/EntityDiscoveryKey"},{"type":"object","properties":{"alias":{"type":"string"},"basePath":{"type":"string"},"projectName":{"type":"string"},"repoName":{"type":"string"}}}]},"AZURE_RESOURCES":{"required":["identifier"],"type":"object","allOf":[{"$ref":"#/components/schemas/EntityDiscoveryKey"},{"type":"object","properties":{"alias":{"type":"string"},"identifier":{"type":"string"}}}]},"BITBUCKET":{"required":["repoName"],"type":"object","allOf":[{"$ref":"#/components/schemas/EntityDiscoveryKey"},{"type":"object","properties":{"alias":{"type":"string"},"basePath":{"type":"string"},"repoName":{"type":"string"}}}]},"DATADOG":{"required":["serviceName"],"type":"object","allOf":[{"$ref":"#/components/schemas/EntityDiscoveryKey"},{"type":"object","properties":{"serviceName":{"type":"string"}}}]},"DYNATRACE":{"required":["entityId"],"type":"object","allOf":[{"$ref":"#/components/schemas/EntityDiscoveryKey"},{"type":"object","properties":{"entityId":{"type":"string"}}}]},"ECS":{"required":["clusterArn","serviceArn"],"type":"object","allOf":[{"$ref":"#/components/schemas/EntityDiscoveryKey"},{"type":"object","properties":{"clusterArn":{"type":"string"},"serviceArn":{"type":"string"}}}]},"GCP":{"required":["projectId","resourceName","resourceType"],"type":"object","allOf":[{"$ref":"#/components/schemas/EntityDiscoveryKey"},{"type":"object","properties":{"projectId":{"type":"string"},"resourceName":{"type":"string"},"resourceType":{"type":"string","enum":["AI_DATASET","AI_ENDPOINT","AI_FEATURESTORE","AI_PLATFORM_INDEX_ENDPOINT","AI_INDEX","AI_BATCH_PREDICTION_JOB","AI_MODEL_DEPLOYMENT_MONITORING_JOB","AI_MODEL","AI_TRAINING_PIPELINE","AI_PIPELINE_JOB","AI_SPECIALIST_POOL","AI_TENSORBOARD","AI_STUDY","AI_NOTEBOOK_INSTANCE","AI_VISION_APPLICATION","AI_VISION_PROCESSOR","AI_VISION_OPERATOR","AI_VISION_CLUSTER","APP_ENGINE_SERVICE","ARTIFACT_REGISTRY_REPOSITORY","BIGQUERY_CONNECTION","BIGQUERY_DATASET","FUNCTION","GKE_CLUSTER","GKE_OPERATION","INSTANCE_GROUP","LOAD_BALANCER","SQL","STORAGE","TOPIC","VM_INSTANCE","MEMORYSTORE_REDIS","MEMORYSTORE_MEMCACHED","RUN_SERVICE","RUN_JOB","COMPOSER_ENVIRONMENT","IAM_SERVICE_ACCOUNT","SPANNER_INSTANCE_CONFIG","SPANNER_INSTANCE","VPC_SERVERLESS_CONNECTOR","APIGEE_INSTANCE","APIGEE_API","PROJECT"]}}}]},"GITHUB":{"required":["repoName"],"type":"object","allOf":[{"$ref":"#/components/schemas/EntityDiscoveryKey"},{"type":"object","properties":{"alias":{"type":"string"},"basePath":{"type":"string"},"repoName":{"type":"string"}}}]},"GITLAB":{"required":["projectId"],"type":"object","allOf":[{"$ref":"#/components/schemas/EntityDiscoveryKey"},{"type":"object","properties":{"alias":{"type":"string"},"basePath":{"type":"string"},"projectId":{"type":"string"}}}]},"INSTANA":{"required":["label"],"type":"object","allOf":[{"$ref":"#/components/schemas/EntityDiscoveryKey"},{"type":"object","properties":{"label":{"type":"string"}}}]},"K8S":{"required":["identifier","k8sType"],"type":"object","allOf":[{"$ref":"#/components/schemas/EntityDiscoveryKey"},{"type":"object","properties":{"identifier":{"type":"string"},"k8sType":{"type":"string","enum":["DEPLOYMENT","STATEFUL_SET","ARGO_ROLLOUT","CRON_JOB"]}}}]},"LAMBDA":{"required":["arn"],"type":"object","allOf":[{"$ref":"#/components/schemas/EntityDiscoveryKey"},{"type":"object","properties":{"arn":{"type":"string"}}}]},"LIGHTSTEP":{"required":["name"],"type":"object","allOf":[{"$ref":"#/components/schemas/EntityDiscoveryKey"},{"type":"object","properties":{"name":{"type":"string"}}}]},"NEWRELIC":{"required":["id"],"type":"object","allOf":[{"$ref":"#/components/schemas/EntityDiscoveryKey"},{"type":"object","properties":{"id":{"type":"string"}}}]},"SERVICENOW":{"required":["id","tableName"],"type":"object","allOf":[{"$ref":"#/components/schemas/EntityDiscoveryKey"},{"type":"object","properties":{"id":{"type":"string"},"tableName":{"type":"string"}}}]},"TooManyRequestsProblemDetail":{"required":["type","title","status"],"type":"object","properties":{"detail":{"type":"string"},"instance":{"type":"string","format":"uri-reference"},"retryAfter":{"minimum":0,"type":"integer","description":"The number of seconds until the rate limiting resets.","format":"int32"},"status":{"maximum":599,"minimum":100,"type":"integer","format":"int32","enum":[429]},"title":{"type":"string"},"type":{"type":"string","format":"uri-reference"}}}},"responses":{"TooManyRequests":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsProblemDetail"}}},"description":"The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.","headers":{"Retry-After":{"description":"The number of seconds until the rate limiting resets.","schema":{"minimum":0,"type":"integer","format":"int32"}}}}}},"paths":{"/api/v1/discovery-audit":{"get":{"description":"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.","operationId":"getDiscoveryAudit","parameters":[{"description":"Filter based on type of the event","in":"query","name":"type","required":false,"schema":{"type":"string","enum":["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"]}},{"description":"Filter based on integration source","in":"query","name":"source","required":false,"schema":{"type":"string","enum":["AWS","AZURE_DEVOPS","AZURE_RESOURCES","BITBUCKET","DATADOG","DYNATRACE","ECS","GCP","GITHUB","GITLAB","INSTANA","K8S","LIGHTSTEP","LAMBDA","LAMBDA_CLOUD_CONTROL","NEWRELIC","SERVICENOW","SERVICENOW_DOMAIN"]}},{"description":"Flag to include ignored events in result","in":"query","name":"includeIgnored","required":false,"schema":{"type":"boolean","default":false}},{"description":"Number of results to return per page, between 1 and 1000. Default 250.","in":"query","name":"pageSize","required":true,"schema":{"type":"integer","format":"int32","default":250}},{"description":"Page number to return, 0-indexed. Default 0.","in":"query","name":"page","required":true,"schema":{"type":"integer","format":"int32","default":0}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DiscoveryAuditReportResponse"}}},"description":"Successfully retrieved discovery audit report"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"summary":"Retrieve discovery audit report","tags":["Discovery Audit"]}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cortex.io/api/readme/discovery-audit.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.