GRgrepr
Integration Exceptions

Get the usage of an integration's parsed queries

Returns the usage the observability vendor reports for the source of each parsed query, such as when a Datadog dashboard was last viewed and its total views, with whether the last attempt to read it worked. Queries the vendor reported nothing for are absent rather than reported as never viewed.

get/v1/integrations/{integrationId}/exceptions/usage

Request

  • Base URL
    https://docs.grepr.ai (the document declares no server; this is the origin it was published from)
  • Auth
    • API key in header GREPR-API-KEY
    • or OpenID Connect (https://grepr-prod.us.auth0.com/.well-known/openid-configuration)

Path parameters

integrationIdstring required

Integration id

Response

Usage retrieved

reportedTypesstring[] required

The parsed query exception types (values of a parsed query's exceptionType) the vendor reports usage for. Empty when the vendor reports none; a query of any other type has no usage to show.

usageobject required

Usage keyed by composite exception id (integrationId:vendorResourceId:exceptionType), the key the impacts endpoint uses. A query the vendor reported nothing for is absent, which is not the same as never viewed.

Example response

{
  "reportedTypes": [
    "DATADOG_DASHBOARD"
  ],
  "status": {
    "collectedAt": "2026-09-27T18:45:03Z",
    "detail": "the application key needs the dashboards_read permission"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.