Show seat usage for one licence
seat_usageRetrieve a licence’s seat cap, live activation count, and complete activation records to audit assigned seats and spot stale check-ins. Read-only; requires licence ID and authorized principal.
Instructions
Show the seat picture for one licence: its seat cap, how many activations are live, and every activation on record (install label, status, activated-at, last check-in, stale flag; install ids are truncated off the owner surface). Caller must be a principal of class tenant_owner, issuer, or support_reader. An unknown licence returns state LICENSE_UNKNOWN. Use activation_list to browse activations across licences and activation_inspect for one activation with its receipts. Read-only.
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": {
"license_id": "<license_id>",
"_tenant_id": "<_tenant_id>",
"_principal_id": "<_principal_id>"
},
"name": "seat_usage"
}
}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. | |
| license_id | Yes | Licence whose seats to report. | |
| _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 |
|---|---|---|---|
| state | No | ||
| seats_cap | No | ||
| license_id | No | ||
| live_count | No | ||
| activations | No |