---
title: "Change the number a business's assistants give to callers (agents:write). Updates the business phone and, by default, redeploys each assigned assistant's stored inbound prompt unchanged so the new number reaches callers."
method: POST
path: "/v1/business/phone"
---

# Change the number a business's assistants give to callers (agents:write). Updates the business phone and, by default, redeploys each assigned assistant's stored inbound prompt unchanged so the new number reaches callers.

`POST /v1/business/phone`

## Request

- Base URL: `https://www.kaicalls.com/api`
- URL: `https://www.kaicalls.com/api/v1/business/phone`
- Auth: HTTP bearer

## Request body

- object
  - `business_id` string, required
  - `phone` string, required: New caller-facing phone number.
  - `redeploy` boolean: Recompile every assigned assistant's prompt with the new number.
  - `reason` string: Why the number changed (audit trail).

## Response `200`

Phone updated, with per-assistant redeploy results

## Other responses

- `400`: Missing business_id or invalid phone
- `403`: Missing scope or no access to this business
- `404`: Business not found

---

[API](https://skmtc.dev/kaicalls/apis/kaicalls-public-api.md) · [All operations](https://skmtc.dev/kaicalls/apis/kaicalls-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kaicalls/apis/kaicalls-public-api/revisions/e607fc6cf36e?raw)