API referenceObjectsspend_limit_request

The spend limit request object

⚠️
Preview — this feature is being built; the design below is the spec.

The spend_limit_request object as the API returns it. Every field below appears in every response that returns this object; fields with no value are null rather than missing.

Example

{
  "id": "slr_01JCQ3R5T7V9X1Z3B5D7",
  "type": "spend_limit_request",
  "workspace_id": "wrkspc_01JC0A2C4E6G8J0L2N4Q",
  "requested_by": "user_01J9Y0A2C4E6G8J0L2N4",
  "current_limit_usd": "500.00",
  "requested_limit_usd": "1500.00",
  "period": "month",
  "reason": "Quarter-end batch backfill of 2M support tickets.",
  "status": "approved",
  "decided_by": "user_01J9X1B3D5F7H9K1M3P5",
  "decision_note": "Approved through 31 December.",
  "created_at": "2026-11-05T10:00:00Z",
  "decided_at": "2026-11-05T12:00:00Z",
  "approved_limit_usd": "1200.00"
}

Fields

FieldTypeDescription
idstringUnique id of this object.
typestringThe object type, always spend_limit_request.
workspace_idstringThe workspace it belongs to.
requested_bystringSee the endpoint pages below.
current_limit_usdstringThe workspace limit when the request was made.
requested_limit_usdstringWhat the requester asked for.
periodstringSee the endpoint pages below.
reasonstringSee the endpoint pages below.
statusstringpending, approved, denied or expired (no decision in 14 days).
decided_bystring or nullThe admin who approved or denied it.
decision_notestringSee the endpoint pages below.
created_atstringWhen it was created, RFC 3339 UTC (some older objects use Unix seconds).
decided_atstringSee the endpoint pages below.
approved_limit_usdstringSee the endpoint pages below.

Returned by

Was this page helpful?