---
title: "Hangup Call"
method: POST
path: "/api/v1/phone/calls/{call_id}/hangup"
tags: ["Phone Calls"]
---

# Hangup Call

`POST /api/v1/phone/calls/{call_id}/hangup`

## Path parameters

- `call_id` string, uuid, required

## Query parameters

- `async_command` boolean

## Headers

- `Idempotency-Key` string, nullable

## Response `200`

Successful Response

- union
  - PhoneCallResponse
    - `id` string, uuid, required
    - `origin` 'dedicated_number' | 'shared_imessage_number' | 'dedicated_imessage_number'
    - `local_phone_number` string, nullable
    - `remote_phone_number` string, required
    - `direction` 'outbound' | 'inbound', required
    - `status` 'initiated' | 'ringing' | 'answered' | 'completed' | 'failed' | 'canceled', required
    - `client_websocket_url` string, nullable, required
    - `mode` 'client_websocket' | 'hosted_agent'
    - `hosted_agent_authority_mode` 'contact_scoped' | 'yolo'
    - `voicemail_detection` 'enabled' | 'disabled'
    - `reason` string, nullable
    - `post_call_action_items` PostCallActionResponse[]
      - `id` string, uuid, required
      - `seq` integer, required
      - `action` string, required
      - `details` string, nullable
      - `status` 'open' | 'canceled'
    - `forwardings` PhoneCallForwardingResponse[]
      - `id` string, uuid, required
      - `trigger` 'incoming_action', required
      - `status` 'requested' | 'dialing' | 'forwarded' | 'failed', required
      - `target_type` 'phone' | 'sip', required
      - `target` string, required
      - `requested_at` string, date-time, required
      - `dialing_at` string, date-time, nullable
      - `forwarded_at` string, date-time, nullable
      - `ended_at` string, date-time, nullable
      - `failure_code` string, nullable
    - `use_inkbox_tts` boolean, nullable, required
    - `use_inkbox_stt` boolean, nullable, required
    - `hangup_reason` 'local' | 'remote' | 'max_duration' | 'voicemail' | 'rejected' | 'failed'
    - `started_at` string, date-time, nullable, required
    - `ended_at` string, date-time, nullable, required
    - `is_blocked` boolean
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - CallCommandResponse
    - `call_id` string, uuid, required
    - `state` 'queued' | 'hangup_queued', required

## Other responses

- `422` — Validation Error
- `4XX` — Client error with Support Agent information.
- `5XX` — Server error with Support Agent information.

---

[API](https://skmtc.dev/inkbox/apis/inkbox-api.md) · [All operations](https://skmtc.dev/inkbox/apis/inkbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/inkbox/inkbox-api/revisions/31f357e7e6f8/schema)