Register a product
product_registerRegister a new product in the caller's tenant so tiers can be defined and licences issued; do this before tier_define and use a product_id unique to the tenant.
Instructions
Register a product in the caller's tenant so tiers can be defined and licences issued for it. Tenant_owner only. The registration is journalled. product_id must be new to the tenant (re-registering an existing id fails). custody records the key-custody model for the product: 'witness' (the default -- the tenant holds its signing keys and the platform stores public keys only) or a custodial election where the deployment supports it. Do this before tier_define for the product.
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>",
"_tenant_id": "<_tenant_id>",
"_principal_id": "<_principal_id>"
},
"name": "product_register"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Display name; defaults to the product_id. | |
| custody | No | Key-custody model: 'witness' (default) or 'custodial'. | |
| _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 | New product id, unique within the tenant (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 | ||
| product_id | No |