diff --git a/docs/change_log/2024-07-16-member-banners.md b/docs/change_log/2024-07-16-member-banners.md new file mode 100644 index 0000000000..6877385d6b --- /dev/null +++ b/docs/change_log/2024-07-16-member-banners.md @@ -0,0 +1,7 @@ +--- +title: "Guild Member Banners" +date: "2024-07-16" +breaking: false +--- + +Apps can now access guild member profile banners via the API and Gateway! The [guild member object](#DOCS_RESOURCES_GUILD/guild-member-object) now includes a `banner` field which can be used to create the [guild member banner URL](#DOCS_REFERENCE/image-formatting). \ No newline at end of file diff --git a/docs/resources/Guild.md b/docs/resources/Guild.md index 4b786b68c2..f96c717e98 100644 --- a/docs/resources/Guild.md +++ b/docs/resources/Guild.md @@ -353,6 +353,7 @@ A partial [guild](#DOCS_RESOURCES_GUILD/guild-object) object. Represents an Offl | user? | [user](#DOCS_RESOURCES_USER/user-object) object | the user this guild member represents | | nick? | ?string | this user's guild nickname | | avatar? | ?string | the member's [guild avatar hash](#DOCS_REFERENCE/image-formatting) | +| banner? | ?string | the member's [guild banner hash](#DOCS_REFERENCE/image-formatting) | | roles | array of snowflakes | array of [role](#DOCS_TOPICS_PERMISSIONS/role-object) object ids | | joined_at | ISO8601 timestamp | when the user joined the guild | | premium_since? | ?ISO8601 timestamp | when the user started [boosting](https://support.discord.com/hc/en-us/articles/360028038352-Server-Boosting-) the guild | @@ -377,6 +378,7 @@ A partial [guild](#DOCS_RESOURCES_GUILD/guild-object) object. Represents an Offl "user": {}, "nick": "NOT API SUPPORT", "avatar": null, + "banner": null, "roles": [], "joined_at": "2015-04-26T06:26:56.936000+00:00", "deaf": false, diff --git a/docs/topics/Gateway_Events.md b/docs/topics/Gateway_Events.md index 0648021de1..6f13cb36af 100644 --- a/docs/topics/Gateway_Events.md +++ b/docs/topics/Gateway_Events.md @@ -764,6 +764,7 @@ Sent when a guild member is updated. This will also fire when the user object of | user | a [user](#DOCS_RESOURCES_USER/user-object) object | User | | nick? | ?string | Nickname of the user in the guild | | avatar | ?string | Member's [guild avatar hash](#DOCS_REFERENCE/image-formatting) | +| banner | ?string | Member's [guild banner hash](#DOCS_REFERENCE/image-formatting) | | joined_at | ?ISO8601 timestamp | When the user joined the guild | | premium_since? | ?ISO8601 timestamp | When the user starting [boosting](https://support.discord.com/hc/en-us/articles/360028038352-Server-Boosting-) the guild | | deaf? | boolean | Whether the user is deafened in voice channels |