v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
Discord

List Discord guild roles

Returns all roles in a Discord guild. Useful for building role-mention pickers, role-permission UIs, or finding the role ID before calling the role-assign endpoint.

Roles are returned unordered — sort client-side by position if you need Discord's UI ordering.

Caller must pass accountId of a Discord SocialAccount bound to this guild (route verifies team access + guild match).

get/v1/discord/guilds/{guildId}/roles

Path parameters

guildIdstring required

Discord guild snowflake ID

Query parameters

accountIdstring required

SocialAccount _id of the Discord account bound to this guild

Response

List of guild roles.