---
title: "Stop call"
method: POST
path: "/api/v4/voice/calls/{call_id}/hangup"
tags: ["Voice"]
---

# Stop call

`POST /api/v4/voice/calls/{call_id}/hangup`

## Request

- Base URL: `https://{cluster_id}.voiso.com`
- URL: `https://{cluster_id}.voiso.com/api/v4/voice/calls/{call_id}/hangup`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/voiso/apis/voiso-api/docs/api/v4/voice/calls/:call_id/hangup/post.ts> (a function with typed inputs; its response is checked against the schema)

End calls for agents from external systems.

## Path parameters

- `call_id` string, uuid, required

## Request body

- object
  - `user_id` integer, required: Agent ID in the contact center.

## Response `200`

OK

- object
  - `call` object, required
    - `id` string, uuid, required: ID assigned to the initiated call.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Unprocessable Entity

---

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