Request to release a Saperly phone number

Tell your AI assistant which Saperly phone number you no longer need. It should show the exact match and wait for your confirmation before submitting a release request.

Your AI

Use with your AI

For tasks with several steps, continue in the AI you already use.

CodexClaude CodeCursorWindsurfCline

View instructions

Use `release-phone-number-saperly` only when the user clearly asks to release one Saperly number. The user may identify it by the full phone number shown in their account, or by its last four digits if those match exactly one number. If needed, use `list-your-phone-numbers-saperly` and rely only on details it actually returns; continue only if one exact phone number and its matching release target are clear. Show the full number and explain that this sends a release request. Wait for the user’s confirmation before submitting. If you cannot verify one exact match or the needed account access, stop and ask the user to choose the number in Saperly; do not ask for an internal ID or guess. Show Saperly’s actual reply and do not assume when service or charges change. Reuse the existing Toolmu connection or follow https://toolmu.com/SKILL.md. Check the current price and honor the user’s authorized spending limit.

Task:
Please release [the Saperly phone number shown in my account]. Show me the full number you found and wait for me to confirm before submitting the release request.

Paste into your connected AI's conversation.

Connection guide

Free

Saperly

Request to release a Saperly phone number

Tell your AI assistant which Saperly phone number you no longer need. It should show the exact match and wait for your confirmation before submitting a release request.

You receive

Saperly’s actual reply to a release request for one number, so you can see what it confirms or reports.

Start with your task

Please release [the Saperly phone number shown in my account]. Show me the full number you found and wait for me to confirm before submitting the release request.

What to know

The reply may not explain when the number stops working or when charges change. Check your Saperly account before assuming either has changed.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
body`body`	`object`	Required	Required fields `numberId`
Number resource ID`body.numberId`	`string`	Required	Required nonempty Saperly number resource ID—the id returned when the number was provisioned. Supply the ID for the number you own and intend to release, not the dialable phone number. Minimum length `1`

View raw JSON

{
  "type": "object",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "numberId"
      ],
      "~standard": {
        "vendor": "zod",
        "version": 1,
        "jsonSchema": {}
      },
      "properties": {
        "numberId": {
          "type": "string",
          "minLength": 1,
          "description": "The Saperly number id (the `id` returned by POST /numbers)."
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Additional notes

Saperly’s phone-number release reference describes releasing a number. The official OpenAPI contract defines the supplier operation and its success and error responses.

Request to release a Saperly phone number

Request to release a Saperly phone number

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Connect your AI assistant to Toolmu

Identify the number you mean

Review Saperly’s reply