Update AI credit controls
Organization Admin permissions are required for this endpoint.
Update the organization’s AI credit controls. This endpoint can be used for embedded instances.
All fields are optional, but at least one must be provided:
- Omit a field to leave it unchanged
- Send
nullto turn that control off (foruserDefaultCreditsandentityGroupDefaultCredits: unlimited by default) - Send a non-negative number to set it
Authorizations
Can be either an Organization API Key or Personal Access Token (PAT).
Include in the Authorization header as: Bearer YOUR_TOKEN
Body
Credit usage at which AI downgrades to a cheaper model. Omit to leave unchanged, null to turn off, or a non-negative number to set. Must be less than or equal to shutoffCredits.
x >= 0800
Credit usage at which AI shuts off entirely. Omit to leave unchanged, null to turn off, or a non-negative number to set.
x >= 01200
Default per-user AI credit limit for the billing period. This limit is what what every user without an individual limit gets. Omit to leave unchanged, null for unlimited by default, or a non-negative number to set.
x >= 0100
Default per-entity-group AI credit limit for the billing period. This limit is what every embed entity group without an individual limit gets. Omit to leave unchanged, null for unlimited by default, or a non-negative number to set.
x >= 0100
Response
Thresholds updated. Returns the full current state.
Monthly AI credit limit for the whole Omni account, which is shared across every organization associated with the account. 0 when no limit is configured.
x >= 02000
This organizations's credit usage for the current billing period.
x >= 0450
Downgrade threshold, or null if the downgrade control is off.
x >= 0800
Default per-entity-group AI credit limit, or null when entity groups are unlimited by default.
x >= 0100
End of the current billing period as a Unix ms timestamp (UTC calendar-month boundary).
x >= 0Start of the current billing period as a Unix ms timestamp (UTC calendar-month boundary).
x >= 0Shutoff threshold, or null if the shutoff control is off.
x >= 01200
Default per-user AI credit limit, or null when users are unlimited by default.
x >= 0100

