---
title: "Update an Application"
method: POST
path: "/Accounts/{AccountSid}/Applications/{Sid}"
tags: ["Applications"]
---

# Update an Application

`POST /Accounts/{AccountSid}/Applications/{Sid}`

Changes how an Application routes voice and messaging requests or status callbacks while preserving its SID. The change is also visible through [Update cXML application](/docs/apis/rest/cxml-applications/update-cxml-application), because both operations manage the same application.

#### Permissions

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

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

## Path parameters

- `AccountSid` string, uuid, required — Universal Unique Identifier.
- `Sid` string, uuid, required — Universal Unique Identifier.

## Response `200`

The request has succeeded.

- ApplicationResponse — Response containing a single application.
  - `sid` string, uuid, required — Universal Unique Identifier.
  - `account_sid` string, uuid, required — Universal Unique Identifier.
  - `api_version` string, required — The version of the SignalWire API.
  - `date_created` string, required — The date, in RFC 2822 GMT format, this Application was created.
  - `date_updated` string, required — The date, in RFC 2822 GMT format, this Application was updated.
  - `friendly_name` string, required — A named unique identifier for the resource.
  - `uri` string, required — The URI for this Application.
  - `voice_url` string, nullable, required — The URL to request when a phone number receives a call or fax.
  - `voice_method` string, nullable, required — Whether the request to `VoiceUrl` is a `GET` or a `POST`. Default is `POST`.
  - `voice_fallback_url` string, nullable, required — The URL SignalWire will request if errors occur when fetching the `VoiceUrl`.
  - `voice_fallback_method` string, nullable, required — Whether the request to `VoiceFallbackUrl` is a `GET` or a `POST`. Default is `POST`.
  - `status_callback` string, nullable, required — The URL to pass status updates to the Application.
  - `status_callback_method` string, nullable, required — Whether the request to the `StatusCallback` URL is a `GET` or a `POST`. Default is `POST`.
  - `voice_caller_id_lookup` boolean, nullable, required — Whether or not to look up a caller's ID from the database. Always null.
  - `sms_url` string, nullable, required — The URL to request when an SMS is received.
  - `sms_method` string, nullable, required — Whether the request to `SmsUrl` is a `GET` or a `POST`. Default is `POST`.
  - `sms_fallback_url` string, nullable, required — The URL SignalWire will request if errors occur when fetching the `SmsUrl`.
  - `sms_fallback_method` string, nullable, required — Whether the request to `SmsFallbackUrl` is a `GET` or a `POST`. Default is `POST`.
  - `sms_status_callback` string, nullable, required — The URL to receive status updates for messages sent via this Application.
  - `sms_status_callback_method` string, nullable, required — Whether the request to `SmsStatusCallback` is a `GET` or a `POST`. Default is `POST`.
  - `message_status_callback` string, nullable, required — The URL to receive status updates for messages sent via this Application.

## Other responses

- `400` — The request was invalid or cannot be processed. Check the error details for more information.
- `401` — Authentication failed. Please verify your credentials and try again.
- `404` — The requested resource was not found. Please verify the resource identifier.
- `422` — The request could not be processed due to validation errors. Check the error details for more information.

## Changes

- **2026-05-12** `2916d5e3072e` — 2 breaking, 2 info
  - the `account_sid` response's property type/format changed from `string`/`uuid` to ``/`` for status `200`
  - the `sid` response's property type/format changed from `string`/`uuid` to ``/`` for status `200`
  - added `#/components/schemas/uuid` to the `account_sid` response property `allOf` list for the response status `200`
  - added `#/components/schemas/uuid` to the `sid` response property `allOf` list for the response status `200`
- **2026-05-12** `5344c0c93a4c` — 1 breaking, 5 info
  - added 'unevaluatedProperties' constraint to the request body
  - added 'unevaluatedProperties' constraint to the response body for the status `200`
  - added 'unevaluatedProperties' constraint to the response body for the status `400`
  - added 'unevaluatedProperties' constraint to the response body for the status `401`
  - …2 more
- …earlier changes not shown

[Full history](https://skmtc.dev/signalwire/apis/compatibility-api/changes/Accounts/:AccountSid/Applications/:Sid/post.md)

---

[API](https://skmtc.dev/signalwire/apis/compatibility-api.md) · [All operations](https://skmtc.dev/signalwire/apis/compatibility-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/signalwire/compatibility-api/revisions/723316346320/schema)