List activations
activation_listLists every activation for a tenant and filters results by licence or status (live, deactivated, reclaimed), so you can audit seat assignments and track activation state.
Instructions
List every activation recorded for the caller's tenant, optionally filtered by license_id or by status (live, deactivated, reclaimed). Caller must be a principal of class tenant_owner, issuer, or support_reader; support_reader sees truncated install ids. Returns the activations, a count, and the surface served. Use seat_usage for the per-licence cap-versus-live summary. 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": {
"_tenant_id": "<_tenant_id>",
"_principal_id": "<_principal_id>"
},
"name": "activation_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | Optional filter: only activations with this status. | |
| _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 | No | Optional filter: only activations of this licence. | |
| _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 | ||
| surface | No | ||
| activations | No |