---
title: "Update an outbound config"
method: PUT
path: "/outbound_configs/{id}"
tags: ["Call"]
---

# Update an outbound config

`PUT /outbound_configs/{id}`

Updates the specified outbound config and returns the updated resource.

## Path parameters

- `id` string, uuid, required

## Request body

- CallManagerOutboundConfigUpdateRequest
  - `name` string — Human-readable name for this outbound config.
  - `detail` string — Free-text description of this outbound config.
  - `destination_whitelist` string[], nullable — ISO 3166 alpha-2 country codes (lowercase). Send null or omit to leave unchanged. Send [] to deny all PSTN calls.
  - `codecs` string, nullable — Comma-separated codec preference list. Send null or omit to leave unchanged. Send empty string to use server default.
  - `default_outgoing_source_number_id` string, uuid — UUID of the customer's default outgoing source number to set. Send `00000000-0000-0000-0000-000000000000` to clear the default. Omit this field (or send `null`) to leave the current value unchanged. The number must belong to the customer, be of type `normal`, and be active.

## Response `200`

The updated outbound config.

- CallManagerOutboundConfig
  - `id` string, uuid — The unique identifier of the outbound config.
  - `customer_id` string, uuid — The customer ID that owns this outbound config. Returned from the `GET /customers` response.
  - `name` string — Human-readable name for this outbound config.
  - `detail` string — Free-text description of this outbound config.
  - `destination_whitelist` string[] — ISO 3166 alpha-2 country codes (lowercase). Empty array = deny all PSTN calls.
  - `codecs` string — Comma-separated codec preference list (e.g. PCMU,PCMA,G729). Empty = server default.
  - `default_outgoing_source_number_id` string, uuid, nullable — UUID of the customer's default outgoing source number, used as the caller ID when an outgoing tel call has no valid caller-supplied source. Set to `00000000-0000-0000-0000-000000000000` to clear the default. The number must belong to the customer, be of type `normal`, and be active. Validated at update time and re-validated at call time. Obtained from the `id` field of the `GET /numbers` response.
  - `tm_create` string, date-time, nullable — Timestamp when the outbound config was created.
  - `tm_update` string, date-time, nullable — Timestamp when the outbound config was last updated.
  - `tm_delete` string, date-time, nullable — Timestamp when the outbound config was deleted (soft-delete).

## Other responses

- `400` — Invalid request (INVALID_ARGUMENT).
- `401` — Authentication required (UNAUTHENTICATED).
- `403` — Insufficient permission (PERMISSION_DENIED).
- `404` — Resource not found (NOT_FOUND).
- `500` — Internal error (INTERNAL).

---

[API](https://skmtc.net/voipbin/apis/voipbin-api.md) · [All operations](https://skmtc.net/voipbin/apis/voipbin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voipbin/voipbin-api/versions/79e779080bcc/schema)