---
title: "Hang up a WhatsApp call"
method: POST
path: "/v1/whatsapp/calls/{id}/terminate"
tags: ["WhatsApp"]
---

# Hang up a WhatsApp call

`POST /v1/whatsapp/calls/{id}/terminate`

## Request

- Base URL: `https://api.pyai.com`
- URL: `https://api.pyai.com/v1/whatsapp/calls/{id}/terminate`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

## Path parameters

- `id` string, required

## Response `200`

Terminated (idempotent on already-ended calls)

- WhatsAppCall
  - `object` string
  - `id` string
  - `number_id` string
  - `wa_call_id` string, nullable: Meta's call id (wacid...).
  - `direction` 'inbound' | 'outbound'
  - `user` string
  - `agent_id` string, nullable
  - `status` 'ringing' | 'accepted' | 'connected' | 'completed' | 'failed' | 'rejected' | 'no_answer' | 'terminated'
  - `failure_reason` string, nullable
  - `started_at` integer, nullable: Unix ms.
  - `connected_at` integer, nullable: Unix ms.
  - `ended_at` integer, nullable: Unix ms.
  - `duration_seconds` integer, nullable
  - `created_at` integer
  - `updated_at` integer

## Other responses

- `401`: Missing or invalid API key (`code: unauthorized`)
- `404`: Resource not found (`code: not_found`)

---

[API](https://skmtc.dev/pyai/apis/pyai-api.md) · [All operations](https://skmtc.dev/pyai/apis/pyai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pyai/apis/pyai-api/revisions/271a1539185b?raw)