Change the state of a subscription (write)
change_subscriptionMove an existing ProAbono subscription: upgrade or downgrade to another offer, start a draft, suspend, or terminate it. Identify it by internal ID; termination takes effect at term end unless immediate is set.
Instructions
WRITE. Moves an existing ProAbono subscription: upgrade or downgrade it to another offer, start a draft one, suspend it, or terminate it. Identify the subscription by its internal identifier, which list_subscriptions returns. Terminating is not an immediate loss of access unless immediate is set -- by default it takes effect at the end of the current term. An upgrade terminates the current subscription and creates a new one on the target offer, so the customer's rights change: re-read them afterwards with get_usages.
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 | What to do with the subscription. | |
| bill_now | No | Trigger billing immediately, where applicable. | |
| immediate | No | For upgrade and terminate: act now instead of at the end of the term. | |
| offer_ref | No | Target offer reference. Required for an upgrade, ignored otherwise. | |
| subscription_id | Yes | Internal identifier of the subscription (Id, from list_subscriptions). |