---
title: "Reassign a phone number to a different connector"
method: PATCH
path: "/v1/agents/{agentId}/telephony/phone-numbers/{phoneNumber}"
tags: ["Phone Numbers"]
---

# Reassign a phone number to a different connector

`PATCH /v1/agents/{agentId}/telephony/phone-numbers/{phoneNumber}`

## Request body

- ReassignPhoneNumberBody — Target connector for reassigning a phone number.
  - `connectorId` string, required — Target connector ID to reassign the phone number to

## Response `200`

Successful response

- PhoneNumberResponse — A phone number owned by the project, plus the connector it routes incoming calls to.
  - `number` string, required — Phone number in E.164 format
  - `projectId` string, required — Project this number belongs to
  - `accountId` string, required — Account this number belongs to
  - `clientEnv` string, required — Client environment (sandbox, pre-release, live)
  - `connectorId` string — Connector this number is routed to

## Other responses

- `400` — Validation error
- `401` — Unauthorized – missing or invalid API key
- `403` — Forbidden – insufficient permissions
- `404` — Resource not found

---

[API](https://skmtc.net/poly/apis/polyai-agents-api.md) · [All operations](https://skmtc.net/poly/apis/polyai-agents-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/poly/polyai-agents-api/revisions/76f3c606e395/schema)