---
title: "Admin End Voice Call Session"
method: POST
path: "/calls/{external_id}/end-session"
tags: ["calls"]
---

# Admin End Voice Call Session

`POST /calls/{external_id}/end-session`

Force-end a live voice call by deleting its LiveKit room (tenant admin only).

## Path parameters

- `external_id` string, required

## Response `200`

Successful Response

- Call — Represents a voice call for API responses.
  - `id` string, uuid, required
  - `external_id` string, required
  - `root_call_id` string, uuid, nullable
  - `external_assistant_id` string, nullable, required
  - `type` 'inboundPhoneCall' | 'outboundPhoneCall' | 'webCall', required
  - `messages` object[], required
  - `transcript` string, required
  - `summary` string, nullable, required
  - `structured_data` object, nullable, required
  - `created_at` string, date-time, required
  - `status` string, required
  - `metadata` union, required
    - DeprecatedFollowUpCallMetadata — Legacy follow-up call metadata (for backwards compatibility).
      - `type` 'deprecated_follow_up'
      - `is_follow_up` boolean, required
      - `original_call_id` string, nullable
    - OutboundCallMetadata — Metadata for outbound calls initiated via run items.
      - `type` 'outbound'
      - `voice_agent_outbound_run_item_ids` string[], required
  - `customer_number` string, nullable, required
  - `recording_url` string, nullable, required
  - `recording_presigned_url` string, nullable
  - `duration_seconds` integer, nullable
  - `ended_reason` string, nullable, required
  - `voice_agent_names` object
  - `voice_agent_id` string, uuid, nullable
  - `voice_agent_group_name` string, nullable
  - `had_warm_transfer` boolean
  - `booking_made` boolean, nullable
  - `attributed_to_human_agent_id` string, uuid, nullable
  - `booking_value_cents` integer, nullable
  - `booking_outcome_set_by_user_id` string, uuid, nullable
  - `booking_outcome_set_at` string, date-time, nullable
  - `booking_status` string, nullable
  - `booking_evidence` string, nullable
  - `outcome_agent_ref` string, nullable
  - `customer_profile_id` string, uuid, nullable
  - `customer_name` string, nullable
  - `participant_recordings` ParticipantRecording[], nullable
    - `identity` string, nullable
    - `role` string, nullable
    - `recording_presigned_url` string, required

## Other responses

- `422` — Validation Error

---

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