Define a product tier (new version)
tier_defineDefine a versioned tier for a registered product, creating the next version with its own journal receipt for auditable licence terms.
Instructions
Define a tier for a registered product. Tiers are versioned and never edited in place: every call creates the next version (previous max + 1) with its own journal receipt, and returns that version. Tenant_owner only; the product must already be registered (see product_register). Defaults: features [], seats 1, perpetual false, term_days null (a term licence then needs an explicit expires_at at proposal time).
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": "tier_define"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seats | No | Default seat count for licences on this tier (default 1). | |
| tier_id | Yes | Tier id within the product (required). | |
| features | No | Feature list the tier grants (default []). | |
| perpetual | No | True if the tier is perpetual by default. | |
| term_days | No | Default term length in days for term licences on this tier. | |
| _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 | Yes | Registered product (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 |
|---|---|---|---|
| receipt | No | ||
| tier_id | No | ||
| version | No | ||
| product_id | No |