Bulk-upsert entity budgets

Error

A valid request URL is required to generate request examples

{
  "results": [
    {
      "entityId": "<string>",
      "ok": true,
      "error": "<string>"
    }
  ]
}

{
  "detail": "<string>",
  "message": "<string>"
}

{
  "detail": "<string>",
  "message": "<string>"
}

{
  "detail": "<string>",
  "message": "<string>"
}

PUT

admin

budgets

{entityType}

bulk

Error

A valid request URL is required to generate request examples

{
  "results": [
    {
      "entityId": "<string>",
      "ok": true,
      "error": "<string>"
    }
  ]
}

{
  "detail": "<string>",
  "message": "<string>"
}

{
  "detail": "<string>",
  "message": "<string>"
}

{
  "detail": "<string>",
  "message": "<string>"
}

Authorizations

x-api-key

string

header

required

Organisation API key. Format: sk_<secret>/<keyname> — the secret portion, a literal slash, and the human-readable key name. The header exulu-api-key is accepted as an alias. A Bearer prefix is tolerated and stripped. Keys with an agent scope are only valid for the scoped agent instance.

Path Parameters

entityType

enum<string>

required

Entity type to budget. One of user, role, team, project, agent, routine.

Available options:

user,

role,

team,

project,

agent,

routine

Body

application/json

entityIds

(string | integer)[]

required

IDs of entities to budget.

Minimum array length: 1

max_budget

number

required

Maximum spend in USD (must be > 0).

budget_duration

enum<string>

required

Available options:

1d,

7d,

30d

budget_reset_at

string

ISO UTC calendar boundary for the next reset. Passed to LiteLLM via /budget/update.

Response

Per-entity results.

results

object[]

Show child attributes

Get my budget

Upsert an entity budget