Skip to main content
A Stage Instance holds information about a live stage.

​
Stage Instance Object

Stage Instance Structure
Privacy Level
Example Stage Instance

​
Definitions

Below are some definitions related to stages.
  • Liveness: A Stage channel is considered live when there is an associated stage instance. Conversely, a Stage channel is not live when there is no associated stage instance.
  • Speakers: A participant of a Stage channel is a speaker when their voice state is not suppressed, and has no request_to_speak_timestamp.
  • Moderators: A member of the guild is a moderator of a Stage channel if they have all of the following permissions:
    • MANAGE_CHANNELS
    • MUTE_MEMBERS
    • MOVE_MEMBERS
  • Topic: This is the blurb that gets shown below the channel’s name, among other places.
  • Public: A Stage instance is public when it has a privacy_level of PUBLIC. While a guild has a public Stage instance:
    • Users in the Stage can have the Stage show in their activities.
    • Invites to the Stage channel will have the stage_instance field.

​
Auto Closing

When a Stage channel has no speakers for a certain period of time (on the order of minutes), the Stage instance will be automatically deleted.

​
Create Stage Instance

Creates a new Stage instance associated to a Stage channel. Returns that Stage instance. Fires a Stage Instance Create Gateway event. Requires the user to be a moderator of the Stage channel.
This endpoint supports the X-Audit-Log-Reason header.
JSON Params
* The stage moderator must have the MENTION_EVERYONE permission for this notification to be sent.

​
Get Stage Instance

Gets the stage instance associated with the Stage channel, if it exists.

​
Modify Stage Instance

Updates fields of an existing Stage instance. Returns the updated Stage instance. Fires a Stage Instance Update Gateway event. Requires the user to be a moderator of the Stage channel.
This endpoint supports the X-Audit-Log-Reason header.
JSON Params

​
Delete Stage Instance

Deletes the Stage instance. Returns 204 No Content. Fires a Stage Instance Delete Gateway event. Requires the user to be a moderator of the Stage channel.
This endpoint supports the X-Audit-Log-Reason header.