> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cawme.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Encerrar Chamada

> DELETE /v1/calls/:callId — Encerra uma chamada ativa

`DELETE /v1/calls/:callId`

Encerra uma chamada ativa. Somente chamadas nos status `QUEUED`, `RINGING` ou `IN_PROGRESS` podem ser encerradas. O status da chamada é definido como `FAILED` e `ended_at` é registrado.

## Requisição

### Cabeçalhos

| Cabeçalho       | Valor            |
| --------------- | ---------------- |
| `Authorization` | `Bearer <token>` |

### Parâmetros de caminho

| Parâmetro | Tipo     | Descrição                       |
| --------- | -------- | ------------------------------- |
| `callId`  | `string` | O ID da chamada a ser encerrada |

## Resposta `204`

Sem conteúdo. A chamada foi encerrada.

## Erros

| Código | Descrição                                                                                 |
| ------ | ----------------------------------------------------------------------------------------- |
| `401`  | Token ausente ou inválido                                                                 |
| `404`  | Chamada não encontrada, já encerrada (`COMPLETED` ou `FAILED`) ou não pertence ao usuário |

## Exemplo

```bash theme={null}
curl -X DELETE https://cawme.com/api/v1/calls/call_xyz789 \
  -H "Authorization: Bearer <token>"
```

<Note>
  Encerrar uma chamada define seu status como `FAILED`. Não existe um status separado `CANCELLED`.
</Note>