Ausgabenlimit · Archiv
archive_business_budgetRequest retirement of a selected budget frame or role share through its human Owner card. Use update_business_budget to change a cap. Setting a cap to zero blocks positive new spending but does not retire the resource.
Select what retires
Read get_business_budgets for the exact resource. For a whole frame, use its budgetId and revision. For one share, keep the parent budgetId, add its allocationId and use that share’s revision as expectedRevision. The frame revision and numeric work-journal receipt revision cannot replace the share’s revision.
Resolve blockers before preparing
A frame cannot retire with Workspace/ads_* identity, another active overlap, active shares or bound advertising exposure. A share cannot retire with active children. Zero-valued shares/children are still active; retiring a parent never silently retires them. Share retirement leaves the parent cap unchanged.
Preparation retires nothing. Human confirmation irreversibly removes future spending authority, retaining identity, consumption and history without cancelling provider work. Exact replay keeps the original key/revision and returns an old receipt. After uncertainty read get_business_change(proposalId) and the resource; never prepare another request to probe success.
Requires current Owner authority, operator:prepare, accounting:read and operations:read. Role retirement also needs existing work:read/write and Workspace write authority.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"budgetId": "<budgetId>",
"expectedRevision": "<expectedRevision>",
"requestKey": "<requestKey>"
},
"name": "archive_business_budget"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| budgetId | Yes | Exact parent budgetId from this workspace's get_business_budgets. Without allocationId selects an independent General frame; with allocationId selects only that role share. Never a proposal ID. | |
| requestKey | Yes | Required caller UUID for this actor/workspace's archive preparation. Reuse the same key with unchanged budgetId and expectedRevision after uncertainty; changed arguments conflict. | |
| allocationId | No | Omit to retire the independent General frame. To retire one role share instead, copy its allocationId together with the same parent budgetId and that allocation's current revision. Active children block retirement. | |
| expectedRevision | Yes | Unchanged revision from the exact resource read used for this change. Stale revisions require a fresh read and renewed intent; never replace a revision during replay. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reason | No | Rejection reason; no requested change was applied. | |
| status | Yes | ||
| replayed | No | Original role/archive receipt replay, not proof of current resource or request state. General is not journal-idempotent. | |
| activates | Yes | ||
| nextAction | No | ||
| proposalId | No | Existing stored human-request identity, not a budgetId or allocationId. | |
| presentation | No | The persisted receipt survives an unavailable card. Read the same proposal; never prepare another request. |