Reclaim stale activation seats
activation_reclaim_staleReclaim seats held by stale activations older than the policy reclaim window, optionally scoped to one product, and return the reclaimed activation IDs and count.
Instructions
Reclaim seats held by stale activations: every live activation in the tenant whose last check-in is older than the reclaim window (30 days by policy default) is marked reclaimed, with a seat_reclaim journal receipt per slot. Optionally scoped to one product. Caller must be tenant_owner or issuer AND hold a live mandate covering the reclaim operation class. Fresh activations are untouched, and running it again reclaims nothing further. Returns the reclaimed activation ids and their count.
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": {
"_tenant_id": "<_tenant_id>",
"_principal_id": "<_principal_id>"
},
"name": "activation_reclaim_stale"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| _tenant_id | Yes | Tenant the call acts for. The tenant must exist; an unknown tenant is refused with state LICENSE_UNKNOWN. Transport authentication is a deployment concern -- this parameter scopes the call, it does not authenticate it. | |
| product_id | No | Optional: reclaim only within this product. | |
| _principal_id | Yes | Acting principal inside the tenant. Principal-gated tools refuse unknown principals and principals of the wrong class; executions (tier T2) additionally require a live, unexpired mandate covering the product and the operation class. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | ||
| reclaimed | No |