---
title: "Update call status"
method: PATCH
path: "/channels/{channel_id}/calls/{external_call_id}"
tags: ["Calls"]
---

# Update call status

`PATCH /channels/{channel_id}/calls/{external_call_id}`

## Request

- Base URL: `https://api2.frontapp.com`
- URL: `https://api2.frontapp.com/channels/{channel_id}/calls/{external_call_id}`
- Auth: HTTP bearer

Updates the call status of a call in Front.

## Path parameters

- `channel_id` string, required
- `external_call_id` string, required

## Request body

- UpdateCall
  - `occurred_at` number: Optional Unix timestamp (ms) when this status change occurred.
  - `call_status` 'queued' | 'ringing' | 'connected' | 'hold' | 'hangup' | 'abandoned' | 'missed' | 'transferred', required
  - `agent_email_address` string: Optional; include when the status update relates to a specific teammate.

## Response `202`

Accepted

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/frontapp/apis/channel-api.md) - [All operations](https://skmtc.dev/frontapp/apis/channel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/frontapp/apis/channel-api/revisions/623b3ec08b56?raw)