Skip to main content
Read and update monthly agent budgets in US dollars. Use the bring-your-own-keys prefix for this workspace mode. The calls use the workspace API key’s BILLING_API scope. Writes run as the key’s service account owner.

Base URL

Dedicated deploymentsReplace api.langdock.com with <your-deployment-url>/api/public in all requests.

Prerequisites

  • API key with the BILLING_API scope
  • The key owner is a service account that has not been deleted and has an active Admin membership

Update a budget

PATCH /agents/{agentId} accepts budget, budgetMode, or both. Send at least one.
budget is a monthly amount:
  • { "type": "limited", "amount": 40 } sets a cap. The amount must be greater than zero.
  • { "type": "unlimited" } keeps a separate budget with no numeric cap. Spend can still be reported. This is different from none.
  • { "type": "none" } removes the separate agent budget. The agent then follows workspace and member limits.
budgetMode chooses when that budget is used:
  • always (Always) counts usage against the agent budget immediately, including API calls, and does not consume the member’s allowance.
  • on_limit_hit (After user limits) counts usage against the member’s limits first. After the member reaches a personal limit, usage counts against the agent budget.
An active agent budget still follows the workspace limit and the workspace agent limit behavior from Billing Workspace Settings. Removing a budget does not turn those controls off. The response is the agent object with budgetPeriodSpend set to null. Read the agent again to get spend.
Langdock intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. For more information, please see our guide on API Key Best Practices.