---
title: "Say that this person has left a call the others are still in."
method: POST
path: "/v1/leave_call_session"
tags: ["Live calls"]
---

# Say that this person has left a call the others are still in.

`POST /v1/leave_call_session`

## Request

- Base URL: `https://partner.mindupload.app`
- URL: `https://partner.mindupload.app/v1/leave_call_session`
- Auth: API key in header `X-Partner-Key`

Says that the person making the request has walked out of a call. Use it whenever somebody leaves, not only when the call is over: it is what keeps the number of people shown beside a call honest, since that number would otherwise count everybody who had ever been in it. It never ends the call and never affects anybody else, so it is safe to send more than once, and it is not refused for being over your allowance. To end a call for everyone, use end_call_session.

## Request body

- object
  - `preferred_language` string, nullable: BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages.
  - `username` string, nullable: The end-user's username.
  - `password` string, nullable: The end-user's password on first sign-in. After login/register, send the returned session token (JWT) here instead — the field accepts either, and reusing the token keeps raw passwords out of your storage.
  - `call_session_id` string, nullable

## Response `200`

Result envelope — check the success field.

- object
  - `success` boolean: Whether the call succeeded.
  - `error_message` string, nullable: Human-readable reason when success is false.
  - `error_code` string

## Other responses

- `400`: Invalid request payload.
- `401`: Missing or invalid partner key.
- `403`: Partner is not authorized for this operation.
- `429`: Rate limit exceeded — retry later.
- `500`: Internal server error.

---

[API](https://skmtc.dev/mindupload/apis/mind-upload-partner-api.md) · [All operations](https://skmtc.dev/mindupload/apis/mind-upload-partner-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mindupload/apis/mind-upload-partner-api/revisions/0371bdf78533?raw)