> For the complete documentation index, see [llms.txt](https://anunzi-ai.gitbook.io/anunzi-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://anunzi-ai.gitbook.io/anunzi-docs/api-calls/detener-llamada.md).

# Detener llamada

**POST** `/v2/stop-call/{call_id}`

Detiene una llamada que está en curso de forma inmediata. Una vez detenida, la llamada pasa a estado `ended` y no puede reanudarse.

***

## Parámetros de ruta

| Campo     | Tipo   | Requerido | Descripción                                                                      |
| --------- | ------ | --------- | -------------------------------------------------------------------------------- |
| `call_id` | string | Sí        | ID de la llamada en curso a detener. Ejemplo: `call_a4441234567890777c4a4a123e6` |

***

## Cuerpo de la solicitud

No requiere cuerpo.

***

## Respuesta — 204 No Content

La llamada fue detenida exitosamente. No se devuelve cuerpo en la respuesta.

***

## Ejemplo de solicitud

```bash
curl --request POST \
     --url https://calls.anunzi.net/v2/stop-call/call_a4441234567890777c4a4a123e6 \
     --header 'Authorization: Bearer TU_API_KEY'
```

***

## Códigos de estado

| Código | Descripción                                             |
| ------ | ------------------------------------------------------- |
| `204`  | Llamada detenida exitosamente. Sin cuerpo de respuesta. |
| `400`  | Formato de solicitud inválido.                          |
| `401`  | API Key ausente o inválida.                             |
| `422`  | La llamada no existe bajo tu API Key.                   |
| `500`  | Error interno del servidor.                             |

***

> ⚠️ Esta acción es irreversible. La razón de desconexión quedará registrada como `manual_stopped`.