---
title: "Update Provider"
method: PATCH
path: "/agents/phone-numbers/providers/{id}"
tags: ["Providers"]
---

# Update Provider

`PATCH /agents/phone-numbers/providers/{id}`

Update a provider's credentials

## Path parameters

- `id` string, required

## Headers

- `Cartesia-Version` '2026-03-01', date, required

## Request body

- UpdateProviderBody — Update Twilio API key credentials and optionally the region. Credentials are validated before applying. If phone numbers using this provider cannot be verified with the new credentials, the update is rejected.
  - `type` 'twilio', required — Must be `"twilio"`.
  - `api_key_sid` string, required — New Twilio API key SID.
  - `api_key_secret` string, required — New API key secret.
  - `region` 'us1' | 'ie1' | 'au1' — The Twilio region the phone number and API key are configured for. `us1` (US), `ie1` (Ireland), `au1` (Australia). Default is `us1`.

## Response `200`

Provider updated.

- ProviderAccountResponse — A linked Twilio account. The `api_key_sid` field is partially masked in responses.
  - `type` 'twilio', required — Always `"twilio"`.
  - `id` string, required — Unique identifier for the provider.
  - `account_sid` string, required — The Twilio account SID.
  - `api_key_sid` string, required — The Twilio API key SID (partially masked).
  - `region` 'us1' | 'ie1' | 'au1', required — The Twilio region the phone number and API key are configured for. `us1` (US), `ie1` (Ireland), `au1` (Australia). Default is `us1`.

## Other responses

- `400` — Invalid credentials, or phone numbers are unreachable with the new credentials. The response includes `unreachable_numbers` listing affected phone numbers.
- `404` — Provider not found.

---

[API](https://skmtc.net/cartesia/apis/cartesia-api.md) · [All operations](https://skmtc.net/cartesia/apis/cartesia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cartesia/cartesia-api/revisions/8910812440d3/schema)