DAdatadog
Usage Metering

Get your temporary grant request

Read an owned request, its decision, and its linked grant state. Requires an authenticated human user. Service-account credentials are unsupported. Request status remains approved after expiry, revocation, or replacement.

get/api/v2/usage/temporary-grant-requests/{request_id}

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.

Path parameters

request_idstring uuid required

The request UUID.

Example:12345678-1234-1234-1234-123456789012

The temporary grant request UUID.

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"
  }
}

Changes

Changes to this operation have not been checked yet.