# Update Numbers ID API

[Tools](/tools) / [Email And Messaging](/tools/category/email-and-messaging) / [Update Numbers ID](/tools/saperly/update-numbers-id)

Update a phone number you own — its AI persona \(instructions, name, language, voice, model, call controls, compliance disclosure, SMS auto-reply\).

Category: [Email And Messaging](/tools/category/email-and-messaging)

## Price

$0.0001 per successful call ≈ 10,000 calls with the $1 signup credit.

Input schema is not available in the local snapshot. Call inspect first; fill body and queryParams as required and replace any pathParams placeholders before running.

## Discover

```sh
curl https://keepbal.com/apis/v1/discover -H 'Authorization: Bearer YOUR_KEEPBAL_KEY' -H 'Content-Type: application/json' -d '{"query":"Update Numbers ID"}'
```

## Inspect

```sh
curl https://keepbal.com/apis/v1/inspect -H 'Authorization: Bearer YOUR_KEEPBAL_KEY' -H 'Content-Type: application/json' -d '{"publicId":"saperly/update-numbers-id"}'
```

## curl

```sh
curl https://keepbal.com/apis/v1/saperly/update-numbers-id \
  -H 'Authorization: Bearer YOUR_KEEPBAL_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"pathParams":{"id":"YOUR_ID"}}'
```

## MCP run_tool

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run_tool",
    "arguments": {
      "tool": "saperly/update-numbers-id",
      "input": {
        "pathParams": {
          "id": "YOUR_ID"
        }
      }
    }
  }
}
```

## Python

```python
import json, os, requests

# Inspect first and replace input_data with the required parameters.
input_data = json.loads("{\"pathParams\":{\"id\":\"YOUR_ID\"}}")
response = requests.post(
    "https://keepbal.com/apis/v1/saperly/update-numbers-id",
    headers={"Authorization": "Bearer " + os.environ["KEEPBAL_API_KEY"]},
    json=input_data,
)
response.raise_for_status()
print(response.json())
```

## Errors and billing

Failed provider calls are not charged. HTTP 400 invalid_request means invalid JSON or parameters, including missing pathParams. HTTP 401 missing_api_key or invalid_api_key means authentication is required. HTTP 402 insufficient_credits means insufficient balance; top up before retrying. HTTP 503 provider_unavailable means the provider is unavailable. A pending run can settle later; poll GET /apis/v1/runs/{id} instead of starting another execution.

## How much does this API cost?

$0.0001 per successful call

## How do I start?

Create a KeepBal account with $1 free credit, obtain an API key, and inspect this tool before running it.

## Related tools

- [Calls ID](/tools/saperly/calls-id) — Get one call by id — direction, status, duration, timestamps. — $0.0001 per successful call
- [Calls ID Recording](/tools/saperly/calls-id-recording) — Get a download URL for the recording of a call placed from your number. — $0.0001 per successful call
- [Calls ID Transcript](/tools/saperly/calls-id-transcript) — Fetch the transcript of a call placed from your number. — $0.0001 per successful call
- [Get Numbers ID](/tools/saperly/get-numbers-id) — Get one of your numbers WITH its live AI persona \(instructions, voice, model, call controls, compliance\) in one call. — $0.0001 per successful call
- [List Calls](/tools/saperly/list-calls) — List the call history of a number you own — inbound and outbound, with status and duration. — $0.0001 per successful call
- [List Languages](/tools/saperly/list-languages) — List the spoken languages an assistant can use \(code + name\). — $0.0001 per successful call



[Start with $1 free credit](/sign-up)

[Tools](/tools) · [MCP documentation](/docs/mcp)