Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

DisconnectUser (Publish) - Amazon IVS

DisconnectUser (Publish)

Disconnects another viewer from the Chat room. Use this in conjunction with the CreateChatToken flow to implement time-based or permanent user bans. For example, to permanently ban a user (viewer), precede this operation with a call to your application service, to prevent the application service from creating another token to the same room. To lift the ban (time- or logic-based), simply resume calling CreateChatToken.

Required Capability

DISCONNECT_USER

Format

{ "Action": "DISCONNECT_USER", "RequestId": "string", "Reason": "string", "UserId": "string" }

Fields

Field Required Description

Action

Yes

DISCONNECT_USER

RequestId

No

An identifier optionally specified by your application for tracking purposes. If specified, this appears in corresponding subscribe operations.

Reason

No

Reason for disconnecting the user.

UserId

Yes

User ID of the user(s) to disconnect from the room. If multiple connections share this ID, all are disconnected.

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.