---
title: "Update call state to ringing"
method: POST
path: "/v1/chats/call/state/ringing/{callId}"
tags: ["Chats"]
---

# Update call state to ringing

`POST /v1/chats/call/state/ringing/{callId}`

## Request

- Base URL: `https://api.chat.ethora.com`
- URL: `https://api.chat.ethora.com/v1/chats/call/state/ringing/{callId}`
- Auth: HTTP bearer

**Auth**: User JWT

Updates the chat call state to `ringing`. This allows the user who initiated the call to detect that the recipient is being notified and start playing the ringing tone.

## Path parameters

- `callId` string, required

## Response `200`

```
{
  ok: boolean,
  callId: string
}
```

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: ``` { error: 'Forbidden' } ```
- `404`: Not Found
- `422`: Unprocessable Entity
- `500`: ``` { error: 'Internal server error' } ```

---

[API](https://skmtc.dev/ethora/apis/platform-api.md) · [All operations](https://skmtc.dev/ethora/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ethora/apis/platform-api/revisions/01b6e64378ee?raw)