discord-http-api-preview_skill

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