Change company billing state
manage_company_billingChanges a company's billing state. activate: active account at the revision and price get_company_billing quoted (minor units, never guessed); without an admin-granted automation budget, admins included, it files a pending human approval and buys nothing. archive: only with confirm:true after the person's explicit yes in this conversation; history stays, and it stops the company's active-account charge from the next end-of-day count, or frees a prepaid place on annual billing. keep: the person still works with a quiet company; it stays active. Archive and keep need an admin or billing permission. Never call this to read, enrich, import or qualify a company.
When to use: The person asks to activate a reviewed company, or answers whether they still work with a quiet one.
Example: We stopped working with Halden & Co. Archive it.
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": {
"account_id": "<account_id>",
"action": "<action>"
},
"name": "manage_company_billing"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | restore is web-only. | |
| confirm | No | archive: true only once the person said yes to archiving this company. | |
| account_id | Yes | The company's uuid, as passed to get_company_billing. | |
| idempotency_key | No | activate and archive: reuse it when retrying the same action. | |
| expected_revision | No | activate and archive: the reviewed `revision`; refused once usage changed. | |
| approved_price_minor | No | activate: the reviewed `activationPriceMinor` (cents or öre); refused if the live price differs. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | ||
| keptAt | No | ||
| account | No | ||
| revision | No | ||
| requestId | No | ||
| approvalUrl | No | ||
| workingCount | No | ||
| approvalRequired | No |