Skip to main content
PUT
Python (SDK)

Authorizations

Authorization
string
header
required

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Query Parameters

org_id
string

Target org; defaults to the caller's own org. Only cluster admins may name another org (org admins may pass their own).

Minimum string length: 1

Body

application/json
period
enum<string>
required
Available options:
daily,
weekly,
monthly
limit
number
required

Spend limit in major currency units

thresholds
object[]
required
Minimum array length: 1
owner
enum<string>
default:org

cluster = operator ceiling (org-admin read-only); org = self-budget

Available options:
cluster,
org
webhook_url
string<uri> | null
webhook_secret
string | null
Minimum string length: 1

Response

200 - application/json

OK

id
string
required
scope
enum<string>
required
Available options:
org,
apikey
scope_id
string
required
scope_org_id
string | null
required
owner
enum<string>
required
Available options:
cluster,
org
period
enum<string>
required
Available options:
daily,
weekly,
monthly
limit
number
required
thresholds
object[]
required
alert_webhook_url
string | null
required
spend
object
required