Change a subscription
change_subscriptionUse this only when a signed in customer clearly asks to pause, resume or cancel one of their teas.co.uk tea subscriptions; confirm which one and which change with them first. subscription_id is the id from my_subscriptions; ids from other accounts are never found. pause needs an active subscription, resume a paused one, and cancel works on either. Cancel is final: a cancelled subscription cannot be resumed here. An unknown id, or a change that does not fit the current status, returns an error and changes nothing. It returns the subscription as it is afterwards. To see the subscriptions first use my_subscriptions.
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": {
"subscription_id": "<subscription_id>",
"action": "<action>"
},
"name": "change_subscription"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | pause stops deliveries until resumed; resume restarts a paused subscription; cancel ends it, and a cancelled subscription cannot be resumed here. | |
| idempotency_key | No | Optional. A unique key for this change (8 to 128 letters, digits or . _ : -). Sending the same key again within 24 hours returns the first answer instead of making the change twice. | |
| subscription_id | Yes | The id from my_subscriptions. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| done | Yes | ||
| subscription | No |