---
title: "Update phone numbers"
method: PUT
path: "/phone-numbers"
tags: ["Phone Numbers"]
---

# Update phone numbers

`PUT /phone-numbers`

## Request

- Base URL: `https://app.freyavoice.ai/api/v2`
- URL: `https://app.freyavoice.ai/api/v2/phone-numbers`
- Auth: HTTP bearer

Updates one or more phone numbers. Returns updated records and any validation errors.

## Request body

- object
  - `workspaceId` string, uuid, required
  - `phoneNumbers` object[], required
    - `id` string, required
    - `number` string
    - `friendlyName` string
    - `config` object
      - `capabilities` object
        - `voice` string
        - `sms` boolean
      - `voiceConfig` string
      - `messagingConfig` string
      - `emergencyCalls` boolean
      - `configType` 'agents' | 'workflows'
      - `inboundAgentId` string
      - `outboundAgentId` string
      - `inboundWorkflowId` string
      - `outboundWorkflowId` string
      - `originationUri` string
      - `sipInbound` object
        - `enabled` boolean, required
      - `sipOutbound` object
        - `enabled` boolean, required
        - `endpoint` string
        - `port` number
        - `username` string
        - `password` string
        - `transportProtocol` 'UDP' | 'TCP' | 'TLS'
        - `secureMedia` boolean
        - `headers` object[]
          - `key` string, required
          - `value` string, required

## Response `200`

Phone numbers updated

- object
  - `success` true, required
  - `data` object, required
    - `message` string, required
    - `result` object, required
      - `updated` object[], required
        - `id` string, required
        - `number` string, required
        - `friendlyName` string, nullable
        - `workspaceId` string, required
        - `userId` string, required
        - `config` object, nullable
          - `capabilities` object
            - `voice` string
            - `sms` boolean
          - `voiceConfig` string
          - `messagingConfig` string
          - `emergencyCalls` boolean
          - `configType` 'agents' | 'workflows'
          - `inboundAgentId` string
          - `outboundAgentId` string
          - `inboundWorkflowId` string
          - `outboundWorkflowId` string
          - `originationUri` string
          - `sipInbound` object
            - `enabled` boolean, required
          - `sipOutbound` object
            - `enabled` boolean, required
            - `endpoint` string
            - `port` number
            - `username` string
            - `password` string
            - `transportProtocol` 'UDP' | 'TCP' | 'TLS'
            - `secureMedia` boolean
            - `headers` object[]
              - …
        - `createdAt` string, required
        - `updatedAt` string, required
        - `inboundAgentName` string, nullable
        - `outboundAgentName` string, nullable
        - `inboundWorkflowName` string, nullable
        - `outboundWorkflowName` string, nullable
      - `errors` object[]
        - `id` string, required
        - `error` string, required
        - `details` object[]
          - `field` string, required
          - `message` string, required

## Other responses

- `400`: Validation error
- `401`: Missing or invalid token
- `500`: Server error

---

[API](https://skmtc.dev/freyavoice/apis/freyavoice-api.md) - [All operations](https://skmtc.dev/freyavoice/apis/freyavoice-api/llms.txt) - [OpenAPI document](https://skmtc.dev/freyavoice/apis/freyavoice-api/revisions/153d120f0c73?raw)