---
title: "Set Phone Number Outbound Agent"
method: PUT
path: "/api/v1/voice-platform/phone-numbers/{phone_number_id}/outbound-agent"
tags: ["phone-assignment"]
---

# Set Phone Number Outbound Agent

`PUT /api/v1/voice-platform/phone-numbers/{phone_number_id}/outbound-agent`

## Request

- Base URL: `https://api.getanana.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getanana.com/api/v1/voice-platform/phone-numbers/{phone_number_id}/outbound-agent`
- Auth: none declared

Choose the agent whose outbound calls this number places, or clear it.

An agent places calls from exactly one number, so choosing this number for
an agent takes the agent off any other number of the tenant. A number
without an outbound trunk cannot be chosen.

## Path parameters

- `phone_number_id` string, uuid, required

## Request body

- OutboundAgentAssignment: Which agent's outbound calls a number places; null stops it placing any.
  - `voice_agent_id` string, uuid, nullable, required

## Response `200`

Successful Response

- TenantPhoneNumberRead: A phone number owned by the caller's tenant (slim, tenant-facing).
  - `id` string, uuid, required
  - `number` string, required
  - `name` string, nullable, required
  - `status` string, nullable, required
  - `voice_platform` string, nullable, required
  - `inbound_voice_agent_id` string, uuid, nullable, required
  - `dispatch_rule_id` string, nullable, required
  - `outbound_voice_agent_id` string, uuid, nullable, required
  - `can_place_calls` boolean, required

## Other responses

- `400`: The agent does not make calls
- `403`: Permission MANAGE_AGENTS required
- `404`: Tenant not found
- `409`: The number cannot place calls
- `410`: Tenant deleted
- `422`: Validation Error

## Changes

> 95 revisions in range; 1 not diffed.

- **2026-11-17** `41e7f0687064`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/voice-platform/phone-numbers/:phone_number_id/outbound-agent/put.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) - [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/4e699bbdcfbd?raw)
