Set the team storage cap and optional money budget
PUT
/v1/usage/budgetcurl -X PUT 'https://api.embodiflow.io/v1/usage/budget' \
-H 'Authorization: Bearer $EMBODIFLOW_PAT' \
-H 'Content-Type: application/json' \
-d '{
"storageLimitBytes": 0,
"monthlyBudgetMinor": 0,
"hardStop": true
}'Authorization
Send a personal access token with every request.
- Authorization: Bearer PAT
Header parameters
- If-Matchstring
Optional precondition. A matching tag proceeds and returns the new ETag. A stale tag returns 412 PRECONDITION_FAILED with no write. Absent proceeds (opt-in this release). If-Match: * succeeds when the resource exists. Malformed values return 400 IF_MATCH_INVALID.
- Idempotency-Keystring
Optional idempotency key, at most 255 characters (UUIDv4 recommended). A repeated key returns the first response byte-for-byte, including a 5xx. The same key with a different body, or a second in-flight request, returns 409 IDEMPOTENCY_CONFLICT. Keys are unique per tenant and retained for 24 hours.
Request body
Content-Typeapplication/json
- storageLimitBytesnumber
- monthlyBudgetMinornumber | null
- hardStopboolean
Responses
Success
- dataobjectrequired
- storageobjectrequired
- moneyobjectrequired
Response example
{
"data": {
"storage": {
"limitBytes": 0,
"ceilingBytes": 0,
"usedBytes": 0,
"pendingBytes": 0,
"trashBytes": 0,
"percent": 0,
"state": "ok"
},
"money": {
"monthlyBudgetMinor": 0,
"currency": "string",
"hardStop": false,
"spentMinor": 0
}
}
}Servershttps://api.embodiflow.io/v1https://api.embodiflow.dev/v1