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.
{ "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.
Updated resource. Spending is null; GET retrieves spending.
Monthly budget in mode currency, subject to workspace enforcement. always uses agent allowance; on_limit_hit uses it after the member allowance. Spend is null when user-level usage is hidden and always null on PATCH.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Docs","colors":{"primary":"#4469FC","light":"#ECF0FF","dark":"#0D001D"},"logo":{"light":"https://mintcdn.com/langdock-34/URgvNwU7CYGZq8R7/logo/light.svg?fit=max\u0026auto=format\u0026n=URgvNwU7CYGZq8R7\u0026q=85\u0026s=594b4bd597e2629fb1a7dccfae6aa1c4","dark":"https://mintcdn.com/langdock-34/URgvNwU7CYGZq8R7/logo/dark.svg?fit=max\u0026auto=format\u0026n=URgvNwU7CYGZq8R7\u0026q=85\u0026s=d063d52fb4d331afb82adad972214673"},"favicon":"https://mintcdn.com/langdock-34/KbxhVmfYOcTup72x/favicon.png?fit=max\u0026auto=format\u0026n=KbxhVmfYOcTup72x\u0026q=85\u0026s=e12cd6cccfe5c94bf4ae6ea4fba7959c","background":{"color":{"dark":"#090014"}},"navbar":{"primary":{"type":"button","label":"Back to app","href":"https://app.langdock.com"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/langdock"}},"errors":{"404":{"redirect":true}},"contextual":{"options":["copy","view","mcp","cursor","vscode",{"title":"Ask Langdock","description":"Ask Langdock about the current page","icon":"/favicon.png","href":{"base":"https://app.langdock.com/chat","query":[{"key":"q","value":"Read from https://docs.langdock.com$path.md so I can ask questions about it."},{"key":"sendPrompt","value":"true"}]}}],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Changelog","icon":"newspaper","href":"https://www.langdock.com/changelog"},{"anchor":"Status","icon":"signal-bars","href":"https://status.langdock.com/"},{"anchor":"Support","icon":"messages-question","href":"https://www.langdock.com/contact-us"}]},"languages":[{"language":"en","default":true,"href":"en/using-langdock/get-started/introduction"},{"language":"de","href":"de/using-langdock/get-started/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"langdock-34","hasAudioNarration":false,"actualSubdomain":"langdock-34","customDomains":["docs.langdock.com"],"gitSource":{"type":"github","owner":"langdock","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae1fb3160416b77ca6b5628","collectionId":"2108c72e-8975-475f-87c4-e4d39ce09ed4","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae1fb3160416b77ca6b5628"},"feedback":{"thumbs":true,"agentFeedback":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"DISABLED"},"CONTEXTUAL_FEEDBACK":{"status":"DISABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae1ff35661bff0c6e733eb8","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"en","tag":"Using Langdock","count":133},{"language":"de","tag":"Langdock nutzen","count":133},{"language":"en","tag":"Developer","count":106},{"language":"de","tag":"Entwickler","count":106},{"language":"en","tag":"Admin","count":100},{"language":"de","tag":"Admin","count":100},{"language":"en","tag":"Manage Integrations","count":43},{"language":"de","tag":"Integrationen verwalten","count":43},{"language":"en","tag":"Guides","count":40},{"language":"de","tag":"Anleitungen","count":40},{"language":"en","tag":"Workflows","count":28},{"language":"de","tag":"Workflows","count":28},{"language":"en","tag":"Integrations","count":19},{"language":"de","tag":"Integrationen","count":19},{"language":"en","tag":"Node Types","count":18},{"language":"de","tag":"Node Types","count":18},{"language":"en","tag":"Integration Setup Guides","count":17},{"language":"de","tag":"Integrations-Setup-Anleitungen","count":17},{"language":"en","tag":"Microsoft Integration Scopes","count":16},{"language":"de","tag":"Microsoft Integration Scopes","count":16}]},"assistantConfig":{"deflection":{"enabled":false}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"en/developer/billing-api/update-agent-budget","slug":"/en/developer/billing-api/update-agent-budget","pageMetadata":{"title":"Update Agent Budget","description":"Set an agent's monthly budget and when that budget applies","openapi":"PATCH /billing/v1/bring-your-own-keys/agents/{agentId}","keywords":["api","billing","agents","budget","budget mode"],"href":"/en/developer/billing-api/update-agent-budget"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Set an agent’s monthly budget and when that budget applies\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Info,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Read and update monthly agent budgets in US dollars. Use the `,_jsx(_components.code,{children:`bring-your-own-keys`}),` prefix for this workspace mode.`]}),`\n`,_jsxs(_components.p,{children:[`The calls use the workspace API key’s `,_jsx(_components.code,{children:`BILLING_API`}),` scope. Writes run as the key’s service account owner.`]}),`\n`,_jsx(Heading,{level:`2`,id:`base-url`,children:`Base URL`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://api.langdock.com/billing/v1/bring-your-own-keys/agents/{agentId}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(Warning,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Dedicated deployments`})}),_jsxs(_components.p,{children:[`Replace `,_jsx(_components.code,{children:`api.langdock.com`}),` with `,_jsx(_components.code,{children:`\u003cyour-deployment-url>/api/public`}),` in all requests.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`API key`}),` with the `,_jsx(_components.code,{children:`BILLING_API`}),` scope`]}),`\n`,_jsx(_components.li,{children:`The key owner is a service account that has not been deleted and has an active Admin membership`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`update-a-budget`,children:`Update a budget`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`PATCH /agents/{agentId}`}),` accepts `,_jsx(_components.code,{children:`budget`}),`, `,_jsx(_components.code,{children:`budgetMode`}),`, or both. Send at least one.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PATCH`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.langdock.com/billing/v1/bring-your-own-keys/agents/33333333-3333-4333-8333-333333333333`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer YOUR_API_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{\"budget\":{\"type\":\"limited\",\"amount\":40},\"budgetMode\":\"always\"}'`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`budget`}),` is a monthly amount:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`{ \"type\": \"limited\", \"amount\": 40 }`}),` sets a cap. The amount must be greater than zero.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`{ \"type\": \"unlimited\" }`}),` keeps a separate budget with no numeric cap. Spend can still be reported. This is different from `,_jsx(_components.code,{children:`none`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`{ \"type\": \"none\" }`}),` removes the separate agent budget. The agent then follows workspace and member limits.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`budgetMode`}),` chooses when that budget is used:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`always`}),` (`,_jsx(_components.strong,{children:`Always`}),`) counts usage against the agent budget immediately, including API calls, and does not consume the member’s allowance.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`on_limit_hit`}),` (`,_jsx(_components.strong,{children:`After user limits`}),`) counts usage against the member’s limits first. After the member reaches a personal limit, usage counts against the agent budget.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`An active agent budget still follows the workspace limit and the workspace agent limit behavior from `,_jsx(_components.a,{href:`/en/developer/billing-api/get-settings`,children:`Billing Workspace Settings`}),`. Removing a budget does not turn those controls off.`]}),`\n`,_jsxs(_components.p,{children:[`The response is the agent object with `,_jsx(_components.code,{children:`budgetPeriodSpend`}),` set to `,_jsx(_components.code,{children:`null`}),`. Read the agent again to get spend.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`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 `,_jsx(_components.a,{href:`/en/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices`,children:`API Key Best Practices`}),`.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Update Agent Budget","description":"Set an agent's monthly budget and when that budget applies","openapi":"PATCH /billing/v1/bring-your-own-keys/agents/{agentId}","keywords":["api","billing","agents","budget","budget mode"],"href":"/en/developer/billing-api/update-agent-budget"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Base URL","slug":"base-url","depth":2,"children":[]},{"title":"Prerequisites","slug":"prerequisites","depth":2,"children":[]},{"title":"Update a budget","slug":"update-a-budget","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Agents"],"operationId":"patchByokBillingAgent","summary":"Update an agent budget in USD","description":"Set an agent's monthly budget and when that budget applies","requestBody":"9de31c4c-62fd-468e-923a-c33142de72be","responses":{"200":"7fc967fa-9d27-4cf7-9da6-96cf6178862f","400":"43805550-1a4b-4ddd-89af-fd196563a87b","401":"c5103972-d955-4979-94e9-b06b78265ed3","403":"580b05c8-da87-461a-a4b5-d3600ff85c5d","404":"a08dfae1-b4c9-41b6-aa8e-0eda8cbc648b","405":"70aad4ec-28cb-4ce8-98d8-280a7cbf5b40","409":"1d657f05-1330-42af-ae46-5aac902fcb30","429":"aa7c0899-5ae0-4ef2-a706-4329f17f87a4"},"method":"patch","type":"path","servers":["1381f949-6199-4dbd-84cd-46b83b072e11"],"security":["88068dfa-de4c-437c-9267-927ebd6ad047"],"path":"/billing/v1/bring-your-own-keys/agents/{agentId}","baseUrlOptions":["https://api.langdock.com"],"title":"Update an agent budget in USD","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"2b9c5af2-dba9-456b-aba8-ebccdb63d828":{"in":"path","name":"agentId","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"budget":{"oneOf":[{"type":"object","description":"Monthly budget in the mode currency. none follows workspace/member limits; unlimited keeps a separate budget without a numeric cap.","required":["type","amount"],"properties":{"type":{"type":"string","enum":["limited"],"isRequired":true,"uniqueKey":"budget.oneOf.0.type","typeLabel":"enum\u003cstring>"},"amount":{"type":"number","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"budget.oneOf.0.amount","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"budget.oneOf.0","typeLabel":"object"},{"type":"object","description":"Monthly budget in the mode currency. none follows workspace/member limits; unlimited keeps a separate budget without a numeric cap.","required":["type"],"properties":{"type":{"type":"string","enum":["unlimited"],"isRequired":true,"uniqueKey":"budget.oneOf.1.type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"budget.oneOf.1","typeLabel":"object"},{"type":"object","description":"Monthly budget in the mode currency. none follows workspace/member limits; unlimited keeps a separate budget without a numeric cap.","required":["type"],"properties":{"type":{"type":"string","enum":["none"],"isRequired":true,"uniqueKey":"budget.oneOf.2.type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"budget.oneOf.2","typeLabel":"object"}],"uniqueKey":"budget","typeLabel":"object"},"budgetMode":{"type":"string","enum":["always","on_limit_hit"],"uniqueKey":"budgetMode","typeLabel":"enum\u003cstring>"}},"minProperties":1,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"budget":{"type":"limited","amount":1}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"7fc967fa-9d27-4cf7-9da6-96cf6178862f":{"description":"Updated resource. Spending is null; GET retrieves spending.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["id","name","budget","budgetMode","budgetPeriodSpend"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"name","typeLabel":"string | null"},"budget":{"oneOf":[{"type":"object","description":"Monthly budget in the mode currency. none follows workspace/member limits; unlimited keeps a separate budget without a numeric cap.","required":["type","amount"],"properties":{"type":{"type":"string","enum":["limited"],"isRequired":true,"uniqueKey":"budget.oneOf.0.type","typeLabel":"enum\u003cstring>"},"amount":{"type":"number","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"budget.oneOf.0.amount","typeLabel":"number"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"budget.oneOf.0","typeLabel":"object"},{"type":"object","description":"Monthly budget in the mode currency. none follows workspace/member limits; unlimited keeps a separate budget without a numeric cap.","required":["type"],"properties":{"type":{"type":"string","enum":["unlimited"],"isRequired":true,"uniqueKey":"budget.oneOf.1.type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"budget.oneOf.1","typeLabel":"object"},{"type":"object","description":"Monthly budget in the mode currency. none follows workspace/member limits; unlimited keeps a separate budget without a numeric cap.","required":["type"],"properties":{"type":{"type":"string","enum":["none"],"isRequired":true,"uniqueKey":"budget.oneOf.2.type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"budget.oneOf.2","typeLabel":"object"}],"isRequired":true,"uniqueKey":"budget","typeLabel":"object"},"budgetMode":{"type":"string","enum":["always","on_limit_hit"],"isRequired":true,"uniqueKey":"budgetMode","typeLabel":"enum\u003cstring>"},"budgetPeriodSpend":{"oneOf":[{"type":"number","minimum":0,"isRequired":true,"uniqueKey":"budgetPeriodSpend.oneOf.0","typeLabel":"number"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"budgetPeriodSpend.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"budgetPeriodSpend","typeLabel":"number | null"}},"description":"Monthly budget in mode currency, subject to workspace enforcement. always uses agent allowance; on_limit_hit uses it after the member allowance. Spend is null when user-level usage is hidden and always null on PATCH.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"\u003cstring>","budget":{"type":"limited","amount":1},"budgetMode":"always","budgetPeriodSpend":1}}},"exampleType":"generated"}},"exampleType":"generated"},"43805550-1a4b-4ddd-89af-fd196563a87b":{"description":"Invalid body/query, unknown fields, empty PATCH, invalid limit, invalid bulk member IDs, or a cursor outside this workspace (INVALID_CURSOR).","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["message","code"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Optional structured details specific to the error code, such as userIds for invalid bulk members.","uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"c5103972-d955-4979-94e9-b06b78265ed3":{"description":"Missing or invalid authentication.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["message","code"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Optional structured details specific to the error code, such as userIds for invalid bulk members.","uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"580b05c8-da87-461a-a4b5-d3600ff85c5d":{"description":"Missing Billing scope, personal key, unavailable feature, missing active service-account Admin authority, or email filter without the USER_MANAGEMENT_API scope.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["message","code"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Optional structured details specific to the error code, such as userIds for invalid bulk members.","uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"a08dfae1-b4c9-41b6-aa8e-0eda8cbc648b":{"description":"Resource not in this workspace, inactive/non-human user, privacy-hidden agent, usage request not found for that member, or endpoint unavailable in this mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["message","code"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Optional structured details specific to the error code, such as userIds for invalid bulk members.","uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"70aad4ec-28cb-4ce8-98d8-280a7cbf5b40":{"description":"Unsupported HTTP method.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["message","code"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Optional structured details specific to the error code, such as userIds for invalid bulk members.","uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"1d657f05-1330-42af-ae46-5aac902fcb30":{"description":"Workspace mode differs from the requested mode. details.mode identifies the workspace mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["message","code","details"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","enum":["BILLING_MODE_MISMATCH"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"details":{"type":"object","additionalProperties":false,"required":["mode"],"properties":{"mode":{"type":"string","enum":["ai-models-included","bring-your-own-keys"],"isRequired":true,"uniqueKey":"details.mode","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"BILLING_MODE_MISMATCH","details":{"mode":"ai-models-included"}}}},"exampleType":"generated"}},"exampleType":"generated"},"aa7c0899-5ae0-4ef2-a706-4329f17f87a4":{"description":"API rate limit exceeded.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["message","code"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Optional structured details specific to the error code, such as userIds for invalid bulk members.","uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"88068dfa-de4c-437c-9267-927ebd6ad047":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API key as Bearer token. Format \"Bearer YOUR_API_KEY\"","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"1381f949-6199-4dbd-84cd-46b83b072e11":{"url":"https://api.langdock.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API key as Bearer token. Format \"Bearer YOUR_API_KEY\"","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key as Bearer token. Format \"Bearer YOUR_API_KEY\"","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"langdock-34","siteName":"Docs","title":"Update Agent Budget - Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/en/developer/billing-api/update-agent-budget","matchLevel":0},"de":{"href":"/de/developer/billing-api/update-agent-budget","matchLevel":1}}},"lastModified":"2026-10-28T13:57:58.432Z","originalFileLocation":"en/developer/billing-api/update-agent-budget.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Set an agent\u0026#x27;s monthly budget and when that budget applies\">\u003cmeta data-mint-head name=\"application-name\" content=\"Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/langdock-34/8EMNQyrrZlRONhj1/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/langdock-34/8EMNQyrrZlRONhj1/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/langdock-34/8EMNQyrrZlRONhj1/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/langdock-34/8EMNQyrrZlRONhj1/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/langdock-34/8EMNQyrrZlRONhj1/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/langdock-34/8EMNQyrrZlRONhj1/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/langdock-34/8EMNQyrrZlRONhj1/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/langdock-34/8EMNQyrrZlRONhj1/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/langdock-34/8EMNQyrrZlRONhj1/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update Agent Budget - Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Set an agent\u0026#x27;s monthly budget and when that budget applies\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.langdock.com/en/developer/billing-api/update-agent-budget\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://langdock-34.mintlify.app/_mintlify/api/og/v2?division=Billing+API\u0026amp;title=Update+Agent+Budget\u0026amp;description=Set+an+agent%27s+monthly+budget+and+when+that+budget+applies\u0026amp;theme=af251cb8027ba7e8fe3cc77e\u0026amp;signature=e9030d1d7816cbe1be86efd8ff0da193f8c6aaa95035ffbc904de80cb0ce2646\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Update Agent Budget - Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Set an agent\u0026#x27;s monthly budget and when that budget applies\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://langdock-34.mintlify.app/_mintlify/api/og/v2?division=Billing+API\u0026amp;title=Update+Agent+Budget\u0026amp;description=Set+an+agent%27s+monthly+budget+and+when+that+budget+applies\u0026amp;theme=af251cb8027ba7e8fe3cc77e\u0026amp;signature=e9030d1d7816cbe1be86efd8ff0da193f8c6aaa95035ffbc904de80cb0ce2646\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/langdock-34/8EMNQyrrZlRONhj1/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4469FC\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.langdock.com/en/developer/billing-api/update-agent-budget\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/developer/billing-api/update-agent-budget.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.langdock.com/en/developer/billing-api/update-agent-budget\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.langdock.com/de/developer/billing-api/update-agent-budget\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.langdock.com/en/developer/billing-api/update-agent-budget\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.langdock.com/#organization\",\"name\":\"Docs\",\"url\":\"https://docs.langdock.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/langdock-34/URgvNwU7CYGZq8R7/logo/light.svg?fit=max\u0026auto=format\u0026n=URgvNwU7CYGZq8R7\u0026q=85\u0026s=594b4bd597e2629fb1a7dccfae6aa1c4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.langdock.com#website\",\"name\":\"Docs\",\"url\":\"https://docs.langdock.com\",\"publisher\":{\"@id\":\"https://docs.langdock.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.langdock.com/en/developer/billing-api/update-agent-budget#webpage\",\"url\":\"https://docs.langdock.com/en/developer/billing-api/update-agent-budget\",\"name\":\"Update Agent Budget\",\"description\":\"Set an agent's monthly budget and when that budget applies\",\"dateModified\":\"2026-10-28T13:57:58.432Z\",\"isPartOf\":{\"@id\":\"https://docs.langdock.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.langdock.com/en/developer/billing-api/update-agent-budget#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.langdock.com/en/developer/billing-api/update-agent-budget#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Billing API\",\"item\":\"https://docs.langdock.com/en/developer/billing-api/billing-api-overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Update Agent Budget\",\"item\":\"https://docs.langdock.com/en/developer/billing-api/update-agent-budget\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.langdock.com/en/developer/billing-api/update-agent-budget#apireference\",\"headline\":\"Update Agent Budget\",\"name\":\"Update Agent Budget\",\"description\":\"Set an agent's monthly budget and when that budget applies\",\"url\":\"https://docs.langdock.com/en/developer/billing-api/update-agent-budget\",\"mainEntityOfPage\":{\"@id\":\"https://docs.langdock.com/en/developer/billing-api/update-agent-budget#webpage\"},\"dateModified\":\"2026-10-28T13:57:58.432Z\",\"keywords\":\"api, billing, agents, budget, budget mode\",\"publisher\":{\"@id\":\"https://docs.langdock.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.langdock.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Docs","nav":{"global":{"anchors":[{"anchor":"Changelog","icon":"newspaper","href":"https://www.langdock.com/changelog"},{"anchor":"Status","icon":"signal-bars","href":"https://status.langdock.com/"},{"anchor":"Support","icon":"messages-question","href":"https://www.langdock.com/contact-us"}]},"languages":[{"language":"en","default":true,"tabs":[{"tab":"Using Langdock","pages":[{"title":"Using Langdock","href":"/en/using-langdock/get-started/introduction"}]},{"tab":"Developer","groups":[{"group":"Overview","pages":[{"title":"API Introduction","href":"/en/developer/overview/api-introduction"},{"title":"Cookbook","href":"/en/developer/overview/cookbook"}]},{"group":"Completion API","pages":[{"title":"Completion API Overview","href":"/en/developer/completion-api/completion-overview"},{"title":"OpenAI Chat completion","openapi":"POST /openai/{region}/v1/chat/completions","href":"/en/developer/completion-api/openai"},{"title":"OpenAI Responses API","openapi":"POST /openai/{region}/v1/responses","href":"/en/developer/completion-api/openai-responses"},{"title":"OpenAI Image Generations","openapi":"POST /openai/{region}/v1/images/generations","href":"/en/developer/completion-api/openai-images"},{"title":"Anthropic Messages","openapi":"POST /anthropic/{region}/v1/messages","href":"/en/developer/completion-api/anthropic"},{"title":"Google Completion API","openapi":"POST /google/{region}/v1beta/models/{model}:generateContent","href":"/en/developer/completion-api/google"},{"title":"Codestral","openapi":"POST /mistral/{region}/v1/fim/completions","href":"/en/developer/completion-api/mistral"}]},{"group":"Embedding API","pages":[{"title":"OpenAI Embeddings","openapi":"POST /openai/{region}/v1/embeddings","href":"/en/developer/embedding-api/openai-embedding"}]},{"group":"Agents API","pages":[{"title":"Agents API Overview","href":"/en/developer/agents-api/agents-overview"},{"title":"Sharing Agents with API Keys","href":"/en/developer/agents-api/agent-api-guide"},{"title":"Agents Completions API","openapi":"POST /agent/v1/chat/completions","href":"/en/developer/agents-api/agent"},{"title":"Agent Get API","openapi":"GET /agent/v1/get","href":"/en/developer/agents-api/agent-get"},{"title":"Agent Create API","openapi":"POST /agent/v1/create","href":"/en/developer/agents-api/agent-create"},{"title":"Agent Update API","openapi":"PATCH /agent/v1/update","href":"/en/developer/agents-api/agent-update"},{"title":"Agent Publish API","openapi":"POST /agent/v1/publish","href":"/en/developer/agents-api/agent-publish"},{"title":"Agent Disable API","openapi":"PATCH /agent/v1/disable","href":"/en/developer/agents-api/agent-disable"},{"title":"Models for Agent API","openapi":"GET /agent/v1/models","href":"/en/developer/agents-api/agent-models"},{"title":"Upload Attachment API","openapi":"POST /attachment/v1/upload","href":"/en/developer/agents-api/upload-attachments"},{"title":"Delete Attachment API","openapi":"DELETE /attachment/v1/delete","href":"/en/developer/agents-api/delete-attachments"},{"title":"Agent Migration Guide","href":"/en/developer/agents-api/agent-migration"},{"title":"Migrating from Assistants API to Agents API","href":"/en/developer/agents-api/assistant-to-agent-migration"}]},{"group":"Integrations API","pages":[{"title":"Integrations API Overview","href":"/en/developer/integrations-api/integrations-overview"},{"title":"List Integrations","openapi":"GET /integrations/v1/get","href":"/en/developer/integrations-api/list-integrations"},{"title":"Create Integration","openapi":"POST /integrations/v1/create","href":"/en/developer/integrations-api/create-integration"},{"title":"Get Integration","openapi":"GET /integrations/v1/{integrationId}","href":"/en/developer/integrations-api/get-integration"},{"title":"Update Integration","openapi":"PATCH /integrations/v1/{integrationId}","href":"/en/developer/integrations-api/update-integration"},{"title":"Get Integration Icon","openapi":"GET /integrations/v1/{integrationId}/icon","href":"/en/developer/integrations-api/get-icon"},{"title":"Replace Integration Icon","openapi":"PUT /integrations/v1/{integrationId}/icon","href":"/en/developer/integrations-api/replace-icon"},{"title":"Update Auth Configuration","openapi":"PATCH /integrations/v1/{integrationId}/auth","href":"/en/developer/integrations-api/update-auth"},{"title":"Create Action","openapi":"POST /integrations/v1/{integrationId}/actions/create","href":"/en/developer/integrations-api/create-action"},{"title":"Update Action","openapi":"PUT /integrations/v1/{integrationId}/actions/{actionId}","href":"/en/developer/integrations-api/update-action"},{"title":"Delete Action","openapi":"DELETE /integrations/v1/{integrationId}/actions/{actionId}","href":"/en/developer/integrations-api/delete-action"},{"title":"Create Trigger","openapi":"POST /integrations/v1/{integrationId}/triggers/create","href":"/en/developer/integrations-api/create-trigger"},{"title":"Update Trigger","openapi":"PUT /integrations/v1/{integrationId}/triggers/{triggerId}","href":"/en/developer/integrations-api/update-trigger"},{"title":"Delete Trigger","openapi":"DELETE /integrations/v1/{integrationId}/triggers/{triggerId}","href":"/en/developer/integrations-api/delete-trigger"}]},{"group":"Skills API","pages":[{"title":"Skills API Overview","href":"/api-endpoints/skills/skills-overview"},{"title":"List Skills","openapi":"GET /skills/v1","href":"/api-endpoints/skills/list-skills"},{"title":"Create Skill","openapi":"POST /skills/v1","href":"/api-endpoints/skills/create-skill"},{"title":"Get Skill","openapi":"GET /skills/v1/{skillId}","href":"/api-endpoints/skills/get-skill"},{"title":"Get Skill File","openapi":"GET /skills/v1/{skillId}/files","href":"/api-endpoints/skills/get-skill-file"},{"title":"Update Skill","openapi":"PATCH /skills/v1/{skillId}","href":"/api-endpoints/skills/update-skill"},{"title":"Delete Skill","openapi":"DELETE /skills/v1/{skillId}","href":"/api-endpoints/skills/delete-skill"},{"title":"Import Skill","openapi":"POST /skills/v1/import","href":"/api-endpoints/skills/import-skill"}]},{"group":"Knowledge Folder API","pages":[{"title":"Knowledge Folder API Overview","href":"/en/developer/knowledge-folder-api/knowledge-folder-overview"},{"title":"Share Knowledge bases with the API","href":"/en/developer/knowledge-folder-api/sharing"},{"title":"Share Knowledge base access","openapi":"post /knowledge/{folderId}/access","href":"/en/developer/knowledge-folder-api/share-access"},{"title":"List Knowledge bases","openapi":"get /knowledge","href":"/en/developer/knowledge-folder-api/list-knowledge-folders"},{"title":"Upload File to Knowledge Folder","openapi":"post /knowledge/{folderId}","href":"/en/developer/knowledge-folder-api/upload-file"},{"title":"Update Attachment in Knowledge Folder","openapi":"patch /knowledge/{folderId}","href":"/en/developer/knowledge-folder-api/update-attachment"},{"title":"Update Knowledge base","openapi":"patch /knowledge/{folderId}/folder","href":"/en/developer/knowledge-folder-api/update-folder"},{"title":"Retrieve Files from Knowledge Folder","openapi":"get /knowledge/{folderId}/list","href":"/en/developer/knowledge-folder-api/retrieve-files"},{"title":"Delete Attachment from Knowledge Folder","openapi":"delete /knowledge/{folderId}/{attachmentId}","href":"/en/developer/knowledge-folder-api/delete-attachment"},{"title":"Search Knowledge bases","openapi":"post /knowledge/search","href":"/en/developer/knowledge-folder-api/search-knowledge-folder"}]},{"group":"Prompt Library API","pages":[{"title":"Prompt Library API Overview","href":"/en/developer/prompts-api/prompts-overview"},{"title":"List Prompts","openapi":"GET /prompts/v1","href":"/en/developer/prompts-api/list-prompts"},{"title":"Create Prompt","openapi":"POST /prompts/v1","href":"/en/developer/prompts-api/create-prompt"},{"title":"Get Prompt","openapi":"GET /prompts/v1/{promptId}","href":"/en/developer/prompts-api/get-prompt"},{"title":"Update Prompt","openapi":"PATCH /prompts/v1/{promptId}","href":"/en/developer/prompts-api/update-prompt"},{"title":"Delete Prompt","openapi":"DELETE /prompts/v1/{promptId}","href":"/en/developer/prompts-api/delete-prompt"},{"title":"List Prompt Folders","openapi":"GET /prompts/v1/folders","href":"/en/developer/prompts-api/list-folders"},{"title":"Create Prompt Folder","openapi":"POST /prompts/v1/folders","href":"/en/developer/prompts-api/create-folder"},{"title":"Get Prompt Folder","openapi":"GET /prompts/v1/folders/{folderId}","href":"/en/developer/prompts-api/get-folder"},{"title":"Update Prompt Folder","openapi":"PATCH /prompts/v1/folders/{folderId}","href":"/en/developer/prompts-api/update-folder"},{"title":"Delete Prompt Folder","openapi":"DELETE /prompts/v1/folders/{folderId}","href":"/en/developer/prompts-api/delete-folder"}]},{"group":"Usage Export API","pages":[{"title":"Usage Export API Overview","href":"/en/developer/usage-export-api/intro-to-usage-export-api"},{"title":"Export User Usage","openapi":"POST /export/users","href":"/en/developer/usage-export-api/export-users"},{"title":"Export Agent Usage","openapi":"POST /export/agents","href":"/en/developer/usage-export-api/export-agents"},{"title":"Export API Key Usage","openapi":"POST /export/api-keys","href":"/en/developer/usage-export-api/export-api-keys"},{"title":"Export Project Usage","openapi":"POST /export/projects","href":"/en/developer/usage-export-api/export-projects"},{"title":"Export Model Usage","openapi":"POST /export/models","href":"/en/developer/usage-export-api/export-models"},{"title":"Export Workflow Usage","openapi":"POST /export/workflows","href":"/en/developer/usage-export-api/export-workflows"}]},{"group":"Workflow API","pages":[{"title":"Workflow API Overview","href":"/en/developer/workflow-api/workflows-overview"},{"title":"List Workflows","openapi":"GET /workflows/v1/list","href":"/en/developer/workflow-api/list-workflows"},{"title":"Create Workflow","openapi":"POST /workflows/v1/create","href":"/en/developer/workflow-api/create-workflow"},{"title":"Get Workflow","openapi":"GET /workflows/v1/get","href":"/en/developer/workflow-api/get-workflow"},{"title":"Update Workflow","openapi":"PATCH /workflows/v1/update","href":"/en/developer/workflow-api/update-workflow"},{"title":"Publish Workflow","openapi":"POST /workflows/v1/publish","href":"/en/developer/workflow-api/publish-workflow"},{"title":"Delete Workflow","openapi":"DELETE /workflows/v1/delete","href":"/en/developer/workflow-api/delete-workflow"},{"title":"List Workflow Runs","openapi":"GET /workflows/v1/runs","href":"/en/developer/workflow-api/list-workflow-runs"},{"title":"Workflow Run Export API","openapi":"GET /workflows/{workflowId}/runs","href":"/en/developer/workflow-api/intro-to-workflow-api"}]},{"group":"Scheduled Tasks API","pages":[{"title":"Scheduled Tasks API Overview","href":"/en/developer/scheduled-tasks-api/scheduled-tasks-overview"},{"title":"List Scheduled Tasks","openapi":"GET /automations/v1","href":"/en/developer/scheduled-tasks-api/list-scheduled-tasks"},{"title":"Create Scheduled Task","openapi":"POST /automations/v1","href":"/en/developer/scheduled-tasks-api/create-scheduled-task"},{"title":"Get Scheduled Task","openapi":"GET /automations/v1/{automationId}","href":"/en/developer/scheduled-tasks-api/get-scheduled-task"},{"title":"Update Scheduled Task","openapi":"PATCH /automations/v1/{automationId}","href":"/en/developer/scheduled-tasks-api/update-scheduled-task"},{"title":"Delete Scheduled Task","openapi":"DELETE /automations/v1/{automationId}","href":"/en/developer/scheduled-tasks-api/delete-scheduled-task"},{"title":"Pause Scheduled Task","openapi":"POST /automations/v1/{automationId}/pause","href":"/en/developer/scheduled-tasks-api/pause-scheduled-task"},{"title":"Resume Scheduled Task","openapi":"POST /automations/v1/{automationId}/resume","href":"/en/developer/scheduled-tasks-api/resume-scheduled-task"},{"title":"Run Scheduled Task","openapi":"POST /automations/v1/{automationId}/run","href":"/en/developer/scheduled-tasks-api/run-scheduled-task"}]},{"group":"User Management API","pages":[{"title":"User Management API Overview","href":"/en/developer/user-management-api/user-management-overview"},{"title":"Invite Users","openapi":"POST /user-management/v1/invite","href":"/en/developer/user-management-api/invite"},{"title":"Update User Role","openapi":"POST /user-management/v1/update-user-role","href":"/en/developer/user-management-api/update-user-role"},{"title":"List Roles","openapi":"GET /user-management/v1/roles","href":"/en/developer/user-management-api/roles"},{"title":"Deactivate User","openapi":"POST /user-management/v1/deactivate-user","href":"/en/developer/user-management-api/deactivate-user"}]},{"group":"Billing API","pages":[{"title":"Billing API Overview","href":"/en/developer/billing-api/billing-api-overview"},{"title":"Get Billing Mode","openapi":"GET /billing/v1/mode","href":"/en/developer/billing-api/get-mode"},{"title":"Get Workspace Settings","openapi":"GET /billing/v1/bring-your-own-keys/settings","href":"/en/developer/billing-api/get-settings"},{"title":"Update Workspace Settings","openapi":"PATCH /billing/v1/bring-your-own-keys/settings","href":"/en/developer/billing-api/update-settings"},{"title":"Count Plan Members","openapi":"GET /billing/v1/bring-your-own-keys/plans","href":"/en/developer/billing-api/get-plans"},{"title":"List Users","openapi":"GET /billing/v1/bring-your-own-keys/users","href":"/en/developer/billing-api/list-users"},{"title":"Get User","openapi":"GET /billing/v1/bring-your-own-keys/users/{userId}","href":"/en/developer/billing-api/get-user"},{"title":"Set User Plan","openapi":"PUT /billing/v1/bring-your-own-keys/users/{userId}/plan","href":"/en/developer/billing-api/set-user-plan"},{"title":"Set User Extra Usage Budget","openapi":"PUT /billing/v1/bring-your-own-keys/users/{userId}/extra-usage-budget","href":"/en/developer/billing-api/set-user-extra-usage-budget"},{"title":"Bulk Set User Plans","openapi":"POST /billing/v1/bring-your-own-keys/users/plan/bulk","href":"/en/developer/billing-api/bulk-set-user-plans"},{"title":"List Usage Requests","openapi":"GET /billing/v1/bring-your-own-keys/usage-requests","href":"/en/developer/billing-api/list-usage-requests"},{"title":"Get Usage Request","openapi":"GET /billing/v1/bring-your-own-keys/usage-requests/{requestId}","href":"/en/developer/billing-api/get-usage-request"},{"title":"Decline Usage Request","openapi":"POST /billing/v1/bring-your-own-keys/usage-requests/{requestId}/dismiss","href":"/en/developer/billing-api/dismiss-usage-request"},{"title":"List Groups","openapi":"GET /billing/v1/bring-your-own-keys/groups","href":"/en/developer/billing-api/list-groups"},{"title":"Get Group","openapi":"GET /billing/v1/bring-your-own-keys/groups/{groupId}","href":"/en/developer/billing-api/get-group"},{"title":"Set Group Monthly Budget","openapi":"PUT /billing/v1/bring-your-own-keys/groups/{groupId}/monthly-budget","href":"/en/developer/billing-api/set-group-monthly-budget"},{"title":"List Agent Budgets","openapi":"GET /billing/v1/bring-your-own-keys/agents","href":"/en/developer/billing-api/list-agents"},{"title":"Get Agent Budget","description":"Read one agent's monthly budget, budget mode, and spend","openapi":"GET /billing/v1/bring-your-own-keys/agents/{agentId}","href":"/en/developer/billing-api/get-agent"},{"title":"Update Agent Budget","openapi":"PATCH /billing/v1/bring-your-own-keys/agents/{agentId}","href":"/en/developer/billing-api/update-agent-budget"}]},{"group":"Audit Logs API","pages":[{"title":"Audit Logs API Overview","description":"Retrieve a record of actions performed in your workspace — who did what, when, and from where.","href":"/en/developer/audit-logs-api/intro-to-audit-logs-api"},{"title":"List Audit Logs","openapi":"GET /audit-logs/{workspace_id}","href":"/en/developer/audit-logs-api/list-audit-logs"}]},{"group":"Compliance API","pages":[{"title":"Export tool parameters and outputs","href":"/en/developer/compliance-api/export-tool-results"}]}]},{"tab":"Admin","pages":[{"title":"Admin","href":"/en/admin/workspace/workspace"}]}]},{"language":"de","pages":[{"title":"de","href":"/de/developer/billing-api/update-agent-budget"}]}]},"title":"Update Agent Budget - Docs","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}