> For the complete documentation index, see [llms.txt](https://requestmechanic.gitbook.io/request-mechanic-api-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://requestmechanic.gitbook.io/request-mechanic-api-documentation/calls/update-call-status.md).

# Update Call Status

Use the `PATCH` `/calls/{call_id}/update/` endpoint to update the status of a call. This helps the backend know whether the call was answered, declined, or has another status. \
**Important:** This endpoint should not be used to end the call.

**Parameters**

* **data** *(body)*: The request body object that contains the call status.
  * **status** (string): The status of the call. Possible values include:
    * `answered`
    * `declined`
    * `ended`
    * `pending`
* **call\_id** *(path)*: The unique identifier of the call that you want to update.

**Example Request Body**

```json
{
  "status": "answered"
}
```

**Responses**

* **200 OK**: The call status was successfully updated.

**Example Response**

```json
{
  "status": "answered"
}
```