Discord

Discord Guilds API

The Guilds API from Discord — 45 operation(s) for guilds.

GitHub OpenAPI

Operations 91

GET /guilds/templates/{code} Get guild template #
GET /guilds/{guild_id} Get guild #
PATCH /guilds/{guild_id} Update guild #
GET /guilds/{guild_id}/audit-logs List guild audit log entries #
GET /guilds/{guild_id}/auto-moderation/rules List auto moderation rules #
POST /guilds/{guild_id}/auto-moderation/rules Create auto moderation rule #
GET /guilds/{guild_id}/auto-moderation/rules/{rule_id} Get auto moderation rule #
DELETE /guilds/{guild_id}/auto-moderation/rules/{rule_id} Delete auto moderation rule #
PATCH /guilds/{guild_id}/auto-moderation/rules/{rule_id} Update auto moderation rule #
GET /guilds/{guild_id}/bans List guild bans #
GET /guilds/{guild_id}/bans/{user_id} Get guild ban #
PUT /guilds/{guild_id}/bans/{user_id} Ban user from guild #
DELETE /guilds/{guild_id}/bans/{user_id} Unban user from guild #
POST /guilds/{guild_id}/bulk-ban Bulk ban users from guild #
GET /guilds/{guild_id}/channels List guild channels #
POST /guilds/{guild_id}/channels Create guild channel #
PATCH /guilds/{guild_id}/channels Bulk update guild channels #
GET /guilds/{guild_id}/emojis List guild emojis #
POST /guilds/{guild_id}/emojis Create guild emoji #
GET /guilds/{guild_id}/emojis/{emoji_id} Get guild emoji #
DELETE /guilds/{guild_id}/emojis/{emoji_id} Delete guild emoji #
PATCH /guilds/{guild_id}/emojis/{emoji_id} Update guild emoji #
PUT /guilds/{guild_id}/incident-actions Update guild incident actions #
GET /guilds/{guild_id}/integrations List guild integrations #
DELETE /guilds/{guild_id}/integrations/{integration_id} Delete guild integration #
GET /guilds/{guild_id}/invites List guild invites #
GET /guilds/{guild_id}/members List guild members #
PATCH /guilds/{guild_id}/members/@me Update my guild member #
GET /guilds/{guild_id}/members/search Search guild members #
GET /guilds/{guild_id}/members/{user_id} Get guild member #
PUT /guilds/{guild_id}/members/{user_id} Add guild member #
DELETE /guilds/{guild_id}/members/{user_id} Delete guild member #
PATCH /guilds/{guild_id}/members/{user_id} Update guild member #
PUT /guilds/{guild_id}/members/{user_id}/roles/{role_id} Add guild member role #
DELETE /guilds/{guild_id}/members/{user_id}/roles/{role_id} Delete guild member role #
GET /guilds/{guild_id}/new-member-welcome Get guild new member welcome #
GET /guilds/{guild_id}/onboarding Get guilds onboarding #
PUT /guilds/{guild_id}/onboarding Put guilds onboarding #
GET /guilds/{guild_id}/preview Get guild preview #
GET /guilds/{guild_id}/prune Preview prune guild #
POST /guilds/{guild_id}/prune Prune guild #
GET /guilds/{guild_id}/regions List guild voice regions #
GET /guilds/{guild_id}/requests Get guild join requests #
PATCH /guilds/{guild_id}/requests/{request_id} Action guild join request #
GET /guilds/{guild_id}/roles List guild roles #
POST /guilds/{guild_id}/roles Create guild role #
PATCH /guilds/{guild_id}/roles Bulk update guild roles #
GET /guilds/{guild_id}/roles/member-counts Guild role member counts #
GET /guilds/{guild_id}/roles/{role_id} Get guild role #
DELETE /guilds/{guild_id}/roles/{role_id} Delete guild role #
PATCH /guilds/{guild_id}/roles/{role_id} Update guild role #
GET /guilds/{guild_id}/scheduled-events List guild scheduled events #
POST /guilds/{guild_id}/scheduled-events Create guild scheduled event #
GET /guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id} Get guild scheduled event #
DELETE /guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id} Delete guild scheduled event #
PATCH /guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id} Update guild scheduled event #
POST /guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}/exceptions Create guild scheduled event exception #
DELETE /guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}/exceptions/{exception_id} Delete guild scheduled event exception #
PATCH /guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}/exceptions/{exception_id} Update guild scheduled event exception #
GET /guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}/users List guild scheduled event users #
GET /guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}/users/counts Count guild scheduled event users #
GET /guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}/{guild_scheduled_event_exception_id}/users List guild scheduled event exception users #
GET /guilds/{guild_id}/soundboard-sounds List guild soundboard sounds #
POST /guilds/{guild_id}/soundboard-sounds Create guild soundboard sound #
GET /guilds/{guild_id}/soundboard-sounds/{sound_id} Get guild soundboard sound #
DELETE /guilds/{guild_id}/soundboard-sounds/{sound_id} Delete guild soundboard sound #
PATCH /guilds/{guild_id}/soundboard-sounds/{sound_id} Update guild soundboard sound #
GET /guilds/{guild_id}/stickers List guild stickers #
POST /guilds/{guild_id}/stickers Create guild sticker #
GET /guilds/{guild_id}/stickers/{sticker_id} Get guild sticker #
DELETE /guilds/{guild_id}/stickers/{sticker_id} Delete guild sticker #
PATCH /guilds/{guild_id}/stickers/{sticker_id} Update guild sticker #
GET /guilds/{guild_id}/templates List guild templates #
POST /guilds/{guild_id}/templates Create guild template #
PUT /guilds/{guild_id}/templates/{code} Sync guild template #
DELETE /guilds/{guild_id}/templates/{code} Delete guild template #
PATCH /guilds/{guild_id}/templates/{code} Update guild template #
GET /guilds/{guild_id}/threads/active Get active guild threads #
GET /guilds/{guild_id}/vanity-url Get guild vanity url #
GET /guilds/{guild_id}/voice-states/@me Get self voice state #
PATCH /guilds/{guild_id}/voice-states/@me Update self voice state #
GET /guilds/{guild_id}/voice-states/{user_id} Get voice state #
PATCH /guilds/{guild_id}/voice-states/{user_id} Update voice state #
GET /guilds/{guild_id}/webhooks Get guild webhooks #
GET /guilds/{guild_id}/welcome-screen Get guild welcome screen #
PATCH /guilds/{guild_id}/welcome-screen Update guild welcome screen #
GET /guilds/{guild_id}/widget Get guild widget settings #
PATCH /guilds/{guild_id}/widget Update guild widget settings #
GET /guilds/{guild_id}/widget.json Get guild widget #
GET /guilds/{guild_id}/widget.png Get guild widget png #

Documentation

📖
Documentation
https://discord.com/developers/docs/reference
📖
Documentation
https://discord.com/developers/docs/tutorials/configuring-app-metadata-for-linked-roles

Specifications

⚙
OpenAPI
https://artifacts.apis.io/discord/openapi/discord-guilds-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/discord:discord-guilds-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

discord-guilds-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Discord HTTP API (Preview) Guilds API
  description: Preview of the Discord v10 HTTP API specification. See https://discord.com/developers/docs for more details.
  termsOfService: https://discord.com/developers/docs/policies-and-agreements/developer-terms-of-service
  license:
    name: MIT
    identifier: MIT
  version: '10'
servers:
- url: https://discord.com/api/v10
tags:


# --- truncated at 32 KB (416 KB total) ---
# Full source: https://artifacts.apis.io/discord/openapi/discord-guilds-api-openapi.yml