---
title: "Update SIP address"
method: PATCH
path: "/api/fabric/sip_addresses/{id}"
tags: ["SIP Addresses"]
---

# Update SIP address

`PATCH /api/fabric/sip_addresses/{id}`

Updates a SIP address by ID. Partial update: any field omitted from the body keeps its current value.
`calling_handler_resource_id` cannot be changed via this endpoint.

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Calling_, _Fax_, _Messaging_, or _Video_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Path parameters

- `id` string, uuid, required — Universal Unique Identifier.

## Request body

- SipAddressUpdateRequest
  - `name` string — URL-safe name for the SIP address — lowercase letters, numbers, and hyphens only (no spaces or other special characters). Must be unique within the project. Defaults to the current value when omitted.
  - `user` string — SIP username used to reach this address (no spaces). Together with the address's Domain, must be unique across your SignalWire account.
  - `context_id` string, uuid — Universal Unique Identifier.
  - `ip_auth_enabled` boolean — Whether to enforce IP authentication for this address.
  - `ip_auth` string[] — Whitelisted IP/CIDR entries. Required (at least one) when `ip_auth_enabled` is `true`. Maximum 256 entries.
  - `codecs` SipAddressCodec[] — Non-empty subset of enabled codecs.
  - `ciphers` Ciphers[] — Non-empty subset of enabled SRTP ciphers.
  - `encryption` 'required' | 'optional' | 'forbidden'
  - `password` string — Write-only SIP registration password. Never returned in any response.

## Response `200`

The request has succeeded.

- SipAddress
  - `id` string, uuid, required — Universal Unique Identifier.
  - `type` 'sip_address', required — The object type. Always `sip_address`.
  - `resource_id` string, uuid, required — Universal Unique Identifier.
  - `name` string, required — URL-safe name for the SIP address. Used to build its SIP URI.
  - `display_name` string, required — Human-friendly label for the SIP address. Defaults to `name`.
  - `context` string, required — The Domain this address is grouped under — for example, `public` for your project's default Domain.
  - `uri` string, required — Full SIP URI for this address.
  - `user` string, required — SIP username used to reach this address. `*` accepts any username.
  - `encryption` 'required' | 'optional' | 'forbidden', required
  - `codecs` SipAddressCodec[], required — Enabled codecs for calls to this address.
  - `ciphers` Ciphers[], required — Enabled SRTP ciphers for calls to this address.
  - `ip_auth_enabled` boolean, required — Whether IP authentication is enforced for this address.
  - `ip_auth` string[], required — Whitelisted IP/CIDR entries used when `ip_auth_enabled` is `true`.
  - `calling_handler_resource_id` string, uuid, required — Universal Unique Identifier.
  - `created_at` string, date-time, required — Date and time when the SIP address was created.
  - `updated_at` string, date-time, required — Date and time when the SIP address was last updated.

## Other responses

- `400` — The request is invalid.
- `401` — Access is unauthorized.
- `404` — The server cannot find the requested resource.
- `422` — The request contains invalid parameters. See errors for details.
- `500` — An internal server error occurred.

---

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