---
title: "Update a Fax"
method: POST
path: "/Accounts/{AccountSid}/Faxes/{Sid}"
tags: ["Faxes"]
---

# Update a Fax

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

Allows you to cancel a queued fax. Only faxes in 'queued' status can be canceled.

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _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.

- FaxResponse — Response containing a single fax.
  - `account_sid` string, required — The unique identifier for the account this fax is associated with.
  - `api_version` string, required — The version of the SignalWire API.
  - `date_created` string, required — The date and time, in ISO 8601 format, the fax was created.
  - `date_updated` string, required — The date and time, in ISO 8601 format, the fax was updated.
  - `direction` 'inbound' | 'outbound', required — Fax direction.
  - `from` string, required — The phone number, in E.164 format, the fax was sent from.
  - `media_url` string, nullable, required — The URL hosting the received media, or null if not available.
  - `media_sid` string, required — The unique identifier for the media instance associated with the fax instance.
  - `num_pages` string, nullable, required — The number of pages in the fax document, or null if not yet determined.
  - `price` string, nullable, required — The cost of the fax, or null if not yet calculated.
  - `price_unit` string, required — The currency, in ISO 4217 format, of the price.
  - `quality` 'standard' | 'fine' | 'superfine', required — Fax quality.
  - `sid` string, required — The unique identifier of the fax.
  - `status` 'queued' | 'processing' | 'sending' | 'delivered' | 'receiving' | 'received' | 'no-answer' | 'busy' | 'failed' | 'canceled', required — Fax status.
  - `to` string, required — The phone number, in E.164 format, the fax was sent to.
  - `duration` integer, required — The time, in seconds, it took to deliver a fax.
  - `links` FaxLinks, required — Fax links.
    - `media` string, required — Media associated with this fax.
  - `url` string, required — The URL of this resource.
  - `error_code` string, nullable, required — Error code for this resource, or null if no error.
  - `error_message` string, nullable, required — The description of this error, or null if no error.

## 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.

---

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