DAdatadog
Usage Metering

Create a temporary grant request

Request a temporary increase to your monthly AI credit limit. Set total to the new monthly limit you need, in whole credits, not the number of credits to add. Include a justification and, optionally, an expiry. If you omit the expiry, the grant ends at the next UTC month boundary. A user with the Billing Edit permission approves or denies the request. Requires an authenticated human user. Service-account credentials are unsupported.

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

Request body

Example request

{
  "data": {
    "attributes": {
      "expires_at": "2028-02-16T00:00:00Z",
      "justification": "Credits needed to finish the incident investigation.",
      "total": 200
    },
    "type": "temporary_grant_requests"
  }
}

Response

Created

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.