---
title: "Kick participants from an active session"
method: POST
path: "/meetings/{meeting_id}/active-session/kick"
tags: ["Active session"]
---

# Kick participants from an active session

`POST /meetings/{meeting_id}/active-session/kick`

## Request

- Base URL: `https://api.dyte.io/v2`
- URL: `https://api.dyte.io/v2/meetings/{meeting_id}/active-session/kick`
- Auth: HTTP basic

Kicks one or more participants from an active session using user ID or custom participant ID.

## Path parameters

- `meeting_id` string, required

## Request body

- object
  - `participant_ids` string[]
  - `custom_participant_ids` string[]

## Response `200`

Kick participants success response

- object
  - `success` boolean
  - `data` object
    - `action` string
    - `participants` SessionParticipant[]
      - `id` string, required: ID of the session participant
      - `created_at` string, required
      - `updated_at` string, required
      - `name` string: Name of the session participant.
      - `email` string: Email of the session participant.
      - `picture` string: A URL pointing to a picture of the participant.

## Other responses

- `404`: No participant found for the given `participant_id` or `custom_participant_id`

## Changes

- **2025-04-04** (v2) `cb67ff854c71`: 1 info
  - the endpoint scheme security `Authorization` was added to the API
- **2025-04-03** (v2) `68b9e665bfcc`: 1 info
  - the endpoint scheme security `Authorization` was removed from the API
- **2024-11-20** (v2) `d8c5d90e84ac`: 1 info
  - the endpoint scheme security `Authorization` was added to the API
- **2023-07-26** (v2) `01a5ec1e8b39`: 1 info
  - api operation id `KickParticipants` removed and replaced with `KickPartcipants`
- **2023-07-18** (v2) `a4d1a35b8f8c`: 1 info
  - api operation id `KickPartcipants` removed and replaced with `KickParticipants`

[Operation history](https://skmtc.dev/dyte-io/apis/dyte-rest-apis/changes/meetings/:meeting_id/active-session/kick/post.md)

---

[API](https://skmtc.dev/dyte-io/apis/dyte-rest-apis.md) - [All operations](https://skmtc.dev/dyte-io/apis/dyte-rest-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/dyte-io/apis/dyte-rest-apis/revisions/f62d3edd92ae?raw)