Propose renewing a licence
license_renew_proposeCreate a proposal to renew an existing license, validating the license and required expiry while inheriting omitted fields. Requires tenant_owner or issuer and changes nothing until confirmed.
Instructions
Create a proposal to renew an existing licence. Validates that the licence exists (unknown ids fail with LICENSE_UNKNOWN) and that a term licence gets a new expires_at; fields left out (tier, licensee, seats) inherit the current licence's values when license_renew executes. Caller must be tenant_owner or issuer. The proposal alone changes nothing and extends nothing. Each call creates a fresh proposal.
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": "license_renew_propose"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seats | No | New seat count; defaults to the current count. | |
| tier_id | No | Tier to renew onto; defaults to the current tier. | |
| licensee | No | Replacement licensee record; defaults to the current one. | |
| _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. | |
| expires_at | No | New ISO-8601 expiry. Required for term licences. | |
| license_id | Yes | Licence to renew (required). | |
| _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 |
|---|---|---|---|
| kind | No | ||
| payload | No | ||
| proposal_id | No | ||
| proposal_hash | No | ||
| confirm_token_shape | No |