Propose issuing a licence
license_issue_proposeValidates a licence issuance request and returns a proposal ID, hash, and confirm-token shape, without issuing anything until confirmed by license_issue.
Instructions
Create a proposal to issue a new licence. A proposal changes nothing by itself: it validates the request (product and tier must exist, seats must be >= 1 and default to the tier's, licensee needs a name and an email, and a term licence needs expires_at or a tier term) and returns a proposal id, its hash, and the confirm-token shape. Caller must be tenant_owner or issuer. Nothing is issued until license_issue executes the proposal with the bound confirm token under a live mandate. 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": {
"product_id": "<product_id>",
"tier_id": "<tier_id>",
"_tenant_id": "<_tenant_id>",
"_principal_id": "<_principal_id>"
},
"name": "license_issue_propose"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seats | No | Seat count (activation cap). Defaults to the tier's seats; must be >= 1. | |
| sandbox | No | True marks the licence as a sandbox/test issuance (default false). | |
| tier_id | Yes | Defined tier of that product (required). | |
| features | No | Feature list to grant. Defaults to the tier's features. | |
| licensee | No | Who the licence is issued to; must carry name and email. | |
| order_ref | No | External order reference carried into the artefact, for reconciliation with the seller's records. | |
| perpetual | No | True for a perpetual licence (no expiry). Defaults to the tier's setting. | |
| _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 | ISO-8601 expiry for a term licence. Omit for perpetual, or when the tier's term_days should set it. | |
| product_id | Yes | Registered product to licence (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. | |
| prev_license_id | No | Previous licence this issuance succeeds, when chaining manually; renewals normally go through license_renew_propose. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | ||
| payload | No | ||
| proposal_id | No | ||
| proposal_hash | No | ||
| confirm_token_shape | No |