Update credit limit for an agent in a space
Update credit limit for an agent in a space.
workflows:write
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
The Admin API version to use for this request.
2026-06-01 Body
Credit limit maximum. Must be a non-negative whole number of credits; other values are rejected with a validation error. Use null to remove the workspace-admin cap.
Response
Effective workspace-admin cap after the edit, or 'null' when no admin cap applies. Always present so the response shape is stable for clients.
The agent's credit usage in the current billing period, or 'null' when the current billing period can't be determined (no known service period).
Whether this save resumed the workflow from a credit-limit or runaway-credit-usage pause.
The agent's true enforced credit limit after the edit, the minimum of: 1. 'credit_limit_by_workspace_admin' 2. the agent-creator-set limit This is the floor that actually gates execution and can differ from 'credit_limit_by_workspace_admin' — e.g. when the editor set a lower limit. The workspace default acts as the fallback when both 'credit_limit_by_workspace_admin' and the agent-creator-set limit are null. 'null' when no limit applies.
Whether the agent is active (not paused) after this edit. 'false' means the edit left or put the agent in a paused state — e.g. setting a cap at or below current usage pauses it, or it was already paused for another reason.