Cancel a verification
cancel_verificationCancel an eligible carrier registration after explicit user authorization.
Awaiting-review drafts are discarded; rejected registrations are dismissed.
A rejected registration must be dismissed before a new one is submitted
for the same country and number type.
An approved US SMS registration can be cancelled: attached numbers lose US texting eligibility
and its monthly fee ends after the current month.
Some registrations have a minimum of three monthly fees even after early cancellation.
Submitting or submitted registrations normally return 409; an accepted SMS campaign
at runtime_setup is an exception.
An SMS application at needs_information supports correction on its existing paid identity.
Returns the cancelled registration or an error.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": {
"verification_id": "<verification_id>"
},
"name": "cancel_verification"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| llm_model | No | Model ID of the calling agent. Optional. Recorded for analytics only. | |
| verification_id | Yes | Registration ID, from ``list_verifications`` or ``submit_verification``. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||