---
title: "Update Call Status"
method: POST
path: "/call/update-call-status"
---

# Update Call Status

`POST /call/update-call-status`

## Request

- Base URL: `https://api.phonely.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.phonely.ai/call/update-call-status`
- Auth: none declared

Update the status of a call

## Headers

- `x-internal-api-key` string, nullable

## Request body

- UpdateCallStatusRequest
  - `callId` string, required
  - `status` 'PREWARMED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'ENDED', required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-07-26** `9bfd5599d479`: 3 info
  - the `header` request parameter `x-internal-api-key` became optional
  - `header` request parameter `x-internal-api-key` list-of-types was widened by adding types `null`
  - for the `header` request parameter `x-internal-api-key`, the type was generalized from `string` to no type

[Operation history](https://skmtc.dev/phonely/apis/phonely-api/changes/call/update-call-status/post.md)

---

[API](https://skmtc.dev/phonely/apis/phonely-api.md) - [All operations](https://skmtc.dev/phonely/apis/phonely-api/llms.txt) - [OpenAPI document](https://skmtc.dev/phonely/apis/phonely-api/revisions/9bfd5599d479?raw)