Skip to main content
Read and update monthly agent budgets in euros. Use the ai-models-included 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.
Call these routes when GET /billing/v1/mode returns ai-models-included. Dedicated deployments always return bring-your-own-keys, including when Langdock manages the model keys. The other mode returns 409 with code BILLING_MODE_MISMATCH.

​
Base URL

​
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
name may be null. budgetPeriodSpend is null when the workspace hides per user spend, and on a write. When per user spend is hidden, agents that are not shared are left out of the list. Reading or updating one of those agents returns 404 and changes nothing. Shared agents stay in the list with budgetPeriodSpend set to null. A configured budget is enforced only while extra usage is on. While extra usage is off, the stored budget is not applied and spend stays at zero.
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.