Skip to main content
DELETE
/
v1
/
chat
/
conversations
/
{id}
/
participants
/
{userId}
cURL
curl --request DELETE \
  --url https://api.botpress.cloud/v1/chat/conversations/{id}/participants/{userId} \
  --header 'Authorization: Bearer <token>' \
  --header 'x-bot-id: <x-bot-id>' \
  --header 'x-bp-authenticated-principal: <x-bp-authenticated-principal>'
{}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-bp-authenticated-principal
string
required

Authenticated principal. Injected by the authentication middleware.

x-bot-id
string
required

Bot id

x-integration-id
string

Integration id

x-integration-alias
string

Integration alias

x-real-ip
string

Caller's IP address. Injected by the edge proxy.

Path Parameters

id
string
required

Conversation id

userId
string
required

User id

Response

Returns an empty object

The response is of type removeParticipantResponse · object.

Last modified on July 3, 2026