home / skills / yuyz0112 / public-api-skills / discord-http-api-preview

discord-http-api-preview skill

safe

This skill helps you interact with the Discord v10 HTTP API by guiding resource usage, operations, and schemas across authentication and endpoints.

npx playbooks add skill yuyz0112/public-api-skills --skill discord-http-api-preview

Review the files below or copy the command above to add this skill to your agents.

Files (858)

SKILL.md

2.3 KB

---
name: discord-http-api-preview
description: Preview of the Discord v10 HTTP API specification. See https://discord.com/developers/docs for more details.. Use when working with the Discord HTTP API (Preview) or when the user needs to interact with this API.
license: MIT
metadata:
  api-version: "10"
  openapi-version: "3.1.0"
---

# Discord HTTP API (Preview)

Preview of the Discord v10 HTTP API specification. See https://discord.com/developers/docs for more details.

## How to Use This Skill

This API documentation is split into multiple files for on-demand loading.

**Directory structure:**
```
references/
├── resources/      # 16 resource index files
├── operations/     # 227 operation detail files
└── schemas/        # 123 schema groups, 490 schema files
```

**Navigation flow:**
1. Find the resource you need in the list below
2. Read `references/resources/<resource>.md` to see available operations
3. Read `references/operations/<operation>.md` for full details
4. If an operation references a schema, read `references/schemas/<prefix>/<schema>.md`

## Base URL

- `https://discord.com/api/v10`

## Authentication

Supported methods: **BotToken**, **OAuth2**. See `references/authentication.md` for details.

## Resources

- **guilds** → `references/resources/guilds.md` (82 ops)
- **channels** → `references/resources/channels.md` (47 ops)
- **applications** → `references/resources/applications.md` (33 ops)
- **webhooks** → `references/resources/webhooks.md` (15 ops)
- **lobbies** → `references/resources/lobbies.md` (13 ops)
- **users** → `references/resources/users.md` (12 ops)
- **invites** → `references/resources/invites.md` (5 ops)
- **oauth2** → `references/resources/oauth2.md` (4 ops)
- **partner-sdk** → `references/resources/partner-sdk.md` (4 ops)
- **stage-instances** → `references/resources/stage-instances.md` (4 ops)
- **gateway** → `references/resources/gateway.md` (2 ops)
- **sticker-packs** → `references/resources/sticker-packs.md` (2 ops)
- **interactions** → `references/resources/interactions.md` (1 ops)
- **soundboard-default-sounds** → `references/resources/soundboard-default-sounds.md` (1 ops)
- **stickers** → `references/resources/stickers.md` (1 ops)
- **voice** → `references/resources/voice.md` (1 ops)

Overview

This skill provides a preview of the Discord v10 HTTP API specification for quick reference while building integrations. It exposes the API base URL, authentication methods, and a navigable set of resource, operation, and schema files for on-demand lookup. Use it to find operation details, request/response shapes, and authentication requirements without browsing the official docs manually.

How this skill works

The skill organizes the API spec into three folders: resource indexes, detailed operation files, and reusable schema files. Start by selecting a resource to see its available operations, open an operation file for parameters and examples, and consult referenced schemas for object shapes. It also surfaces the base URL and supported authentication flows for immediate use in clients or curl calls.

When to use it

Designing or implementing Discord bot or OAuth2 integrations that call the HTTP API
Looking up exact endpoint paths, HTTP methods, parameters, and expected status codes
Verifying JSON request or response schemas referenced by operations
Confirming supported authentication types and token usage
Exploring available resources and operation counts for planning API usage

Best practices

Start from the resource index to find relevant operations before opening specific files
Validate request payloads against referenced schemas to reduce runtime errors
Use the documented authentication methods (BotToken or OAuth2) and follow least-privilege scope practices
Cache static schema or resource metadata locally to reduce repeated lookups
Respect rate limits and consult operation details for status codes and retry guidance

Example use cases

Create a bot flow: find channels resource → read create message operation → check message schema for allowed fields
Implement OAuth2: inspect oauth2 resource for token exchange endpoints and scopes
Automate moderation: review guilds and bans operations to script ban/unban flows with correct parameters
Build webhook integrations: read webhooks operations for creating and executing incoming webhooks with example payloads
Prototype voice or stage features by referencing voice and stage-instances resource operations

FAQ

Is this a complete replacement for the official Discord docs?

No. This preview provides a structured local view of v10 HTTP endpoints and schemas for quick lookup, but you should consult the official Discord developer site for policy, rate limit updates, and long-form guides.

What authentication methods are supported?

The preview documents BotToken and OAuth2 as supported authentication methods. Refer to operation details to see required scopes and header formats for specific endpoints.