---
title: "Update call"
method: POST
path: "/texml/Accounts/{account_sid}/Calls/{call_sid}"
tags: ["TeXML REST Commands"]
---

# Update call

`POST /texml/Accounts/{account_sid}/Calls/{call_sid}`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/texml/Accounts/{account_sid}/Calls/{call_sid}`
- Auth: HTTP bearer

Update TeXML call. Please note that the keys present in the payload MUST BE formatted in CamelCase as specified in the example.

## Path parameters

- `call_sid` string, required
- `account_sid` string, required

## Request body `application/x-www-form-urlencoded`

- UpdateCallRequest
  - `Status` string: The value to set the call status to. Setting the status to completed ends the call.
  - `Url` string: The URL where TeXML will make a request to retrieve a new set of TeXML instructions to continue the call flow.
  - `Method` 'GET' | 'POST': HTTP request type used for `Url`.
  - `FallbackUrl` string: A failover URL for which Telnyx will retrieve the TeXML call instructions if the Url is not responding.
  - `FallbackMethod` 'GET' | 'POST': HTTP request type used for `FallbackUrl`.
  - `StatusCallback` string: URL destination for Telnyx to send status callback events to for the call.
  - `StatusCallbackMethod` 'GET' | 'POST': HTTP request type used for `StatusCallback`.
  - `Texml` string: TeXML to replace the current one with.

## Response `200`

Call resource.

- CallResource
  - `account_sid` string: The id of the account the resource belongs to.
  - `answered_by` 'human' | 'machine' | 'not_sure': The value of the answering machine detection result, if this feature was enabled for the call.
  - `caller_name` string: Caller ID, if present.
  - `date_created` string: The timestamp of when the resource was created.
  - `date_updated` string: The timestamp of when the resource was last updated.
  - `direction` 'inbound' | 'outbound': The direction of this call.
  - `duration` string: The duration of this call, given in seconds.
  - `end_time` string: The end time of this call.
  - `from` string: The phone number or SIP address that made this call.
  - `from_formatted` string: The from number formatted for display.
  - `price` string: The price of this call, the currency is specified in the price_unit field. Only populated when the call cost feature is enabled for the account.
  - `price_unit` string: The unit in which the price is given.
  - `sid` string: The identifier of this call.
  - `start_time` string: The start time of this call.
  - `status` 'ringing' | 'in-progress' | 'canceled' | 'completed' | 'failed' | 'busy' | 'no-answer': The status of this call.
  - `to` string: The phone number or SIP address that received this call.
  - `to_formatted` string: The to number formatted for display.
  - `uri` string: The relative URI for this call.

## Other responses

- `404`: Resource not found
- `422`: Unprocessable entity. The request was well-formed but contains semantic errors.

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/0f17b8167873?raw)