DAdatadog
Usage Metering

List your temporary grant requests

List the authenticated user's own requests, including decided requests. Other users' requests are never included. Requires an authenticated human user. Service-account credentials aren't supported. Request status remains approved after the grant's expiry, revocation, or replacement.

get/api/v2/usage/temporary-grant-requests

Request

  • Base URL
    https://api.datadoghq.com
  • Auth
    • API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
    • or OAuth 2
      Authorization code/oauth2/v1/authorize
      Token URL/oauth2/v1/token
      Scopesassistant_access
    • or OAuth 2
      Authorization code/oauth2/v1/authorize
      Token URL/oauth2/v1/token
      Scopesbits_dev_write
    • or OAuth 2
      Authorization code/oauth2/v1/authorize
      Token URL/oauth2/v1/token
      Scopesbits_investigations_write
    • or OAuth 2
      Authorization code/oauth2/v1/authorize
      Token URL/oauth2/v1/token
      Scopesbits_security_analyst_write
    • or OAuth 2
      Authorization code/oauth2/v1/authorize
      Token URL/oauth2/v1/token
      Scopesagent_builder_run
    • or OAuth 2
      Authorization code/oauth2/v1/authorize
      Token URL/oauth2/v1/token
      Scopesbilling_edit
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Query parameters

filter[status]'pending' | 'approved' | 'denied' | 'cancelled'

The durable request decision, independent of whether its grant is still active.

Example:pending

Optional status. Defaults to all statuses.

page[limit]integer

Page size, from 1 to 100.

page[cursor]string uuid

UUID cursor from meta.page.next_cursor.

Response

OK

Example response

{
  "data": [
    {
      "attributes": {
        "created_at": "2028-02-16T00:00:00Z",
        "decided_at": "2028-02-16T00:00:00Z",
        "decided_by_user_id": "12345678-1234-1234-1234-123456789012",
        "entity_key": "user_handle:jane@example.com",
        "expires_at": "2028-02-16T00:00:00Z",
        "grant_state": "active",
        "justification": "Credits needed to finish the incident investigation.",
        "quota_namespace": "ai_credits",
        "requested_by_user_id": "12345678-1234-1234-1234-123456789012",
        "status": "pending",
        "total": 200
      },
      "id": "12345678-1234-1234-1234-123456789012",
      "type": "temporary_grant_requests"
    }
  ],
  "meta": {
    "page": {
      "next_cursor": "12345678-1234-1234-1234-123456789012"
    }
  }
}

Changes

Changes to this operation have not been checked yet.