Document Guild Scheduled Event structure and HTTP methods

docs/resources/Stage_Instance.md

@@ -102,3 +102,56 @@ Requires the user to be a moderator of the Stage channel.
 
 > info
 > This endpoint supports the `X-Audit-Log-Reason` header.
+
+### Guild Stage Event Object
+
+###### Guild Stage Event Structure
+
+| Field                 | Type                                                                                                   | Description                                                                                           |
+| --------------------- | ------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------- |
+| id                    | snowflake                                                                                              | the id of the stage event                                                                             |
+| guild_id              | snowflake                                                                                              | the id of the guild the stage event belongs to                                                        |
+| channel_id            | snowflake                                                                                              | the id of the stage channel the stage event belongs to                                                |
+| name                  | string                                                                                                 | the name of the stage event                                                                           |
+| description?          | string                                                                                                 | the description of the stage event                                                                    |
+| image                 | ?string                                                                                                | the image of the stage event                                                                          |
+| scheduled_start_time  | ISO8601                                                                                                | the time the stage event will start                                                                   |
+| scheduled_end_time    | ?ISO8601                                                                                               | the time the stage event will end, or `null` if the stage event does not have a scheduled time to end |
+| privacy_level         | [privacy level](#DOCS_RESOURCES_STAGE_INSTANCE/stage-instance-object-privacy-level)                    | stage event privacy level                                                                             |
+| status                | integer                                                                                                | the status of the stage event                                                                         |
+| entity_type           | integer                                                                                                | the entity type of the stage event                                                                    |
+| entity_id             | ?snowflake                                                                                             | entity id                                                                                             |
+| entity_metadata       | [stage entity metadata](#DOCS_RESOURCES_STAGE_INSTANCE/guild-event-object-guild-event-entity-metadata) | metadata for the stage event                                                                          |
+| sku_ids               | array of snowflakes                                                                                    | sku ids                                                                                               |
+| skus                  | array                                                                                                  | skus                                                                                                  |
+
+###### Guild Event Entity Metadata
+
+| Field       | Type                | Description                       |
+| ----------- | ------------------- | --------------------------------- |
+| speaker_ids | array of snowflakes | the speakers of the stage channel |
+
+## List Guild Stage Events % GET /guilds/{guild.id#DOCS_RESOURCES_GUILD/guild-object}/events
+
+Returns a list of [stage events]((#DOCS_RESOURCES_STAGE_INSTANCE/guild-stage-event-object) in the guild.
+
+###### Query String Params
+
+| Field            | Type    | Description                                          |
+| ---------------- | ------- | ---------------------------------------------------- |
+| with_user_count? | boolean | the number of users that are interested in the event |
+
+## Create Guild Stage Event % POST /guilds/{guild.id#DOCS_RESOURCES_GUILD/guild-object}/events
+
+Create a stage event in the guild.
+
+###### JSON Params
+
+| Field                | Type                                                                                | Description                              |
+| -------------------- | ----------------------------------------------------------------------------------- | ---------------------------------------- |
+| channel_id?          | snowflake                                                                           | the stage channel id for the stage event |
+| name                 | string                                                                              | the name of the stage event              |
+| privacy_level        | [privacy level](#DOCS_RESOURCES_STAGE_INSTANCE/stage-instance-object-privacy-level) | the privacy level of the stage event     |
+| scheduled_start_time | ISO8601                                                                             | the time to schedule the stage event     |
+| description?         | string                                                                              | the description of the stage event       |
+| entity_type?         | integer                                                                             | stage event entity type                  |