How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Discord Interactions API

The Discord Interactions API enables applications to create and respond to application commands (slash commands), message components, and modals. It supports both Gateway-based and webhook-based interaction handling, allowing bots to build rich, interactive user experiences within Discord.

Discord Interactions API is one of 29 APIs that Discord publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Components, Interactions, Modals, and Slash Commands. The published artifact set on APIs.io includes API documentation and an OpenAPI specification.

This API exposes 1 operation across 1 path, and defines 50 schemas. It is described by OpenAPI 3.1.0, at version 10.

Requests are made against a single base URL, https://discord.com/api/v10.

1 operations 1 paths 50 schemas 1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
10
Server
https://discord.com/api/v10
Authentication
HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 1

Discord Interactions API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (BotToken). By default, every request must be authenticated.

  • BotToken — Bot token authentication

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.

Interactions 1
POST
/interactions/{interaction_id}/{interaction_token}/callback
create_interaction_response 2 params body → 2044XX

Schemas 50

The contract defines 50 schemas that model the data the API accepts and returns. The most detailed are RichEmbed (13 properties), InputText (9 properties), Button (8 properties), ChannelSelect (8 properties). Each schema is shown below with its type and property counts.

RichEmbedField
object
3 properties 2 required
Int53Type
integer
ApplicationCommandOptionIntegerChoice
object
3 properties 2 required
ApplicationCommandAutocompleteCallbackRequest
object
2 properties 2 required
InteractionApplicationCommandAutocompleteCallbackIntegerData
object
1 property
InputText
object
9 properties 4 required
UpdateMessageInteractionCallbackRequest
object
2 properties 1 required
ChannelSelectDefaultValue
object
2 properties 2 required
MessageAllowedMentionsRequest
object
4 properties
StringSelect
object
7 properties 3 required
MessageAttachmentRequest
object
4 properties 1 required
ApplicationCommandOptionNumberChoice
object
3 properties 2 required
Emoji
object
3 properties 1 required
Button
object
8 properties 2 required
MessageComponentTypes
integer
RichEmbed
object
13 properties
RichEmbedThumbnail
object
5 properties
InteractionApplicationCommandAutocompleteCallbackNumberData
object
1 property
RichEmbedVideo
object
5 properties
SnowflakeSelectDefaultValueTypes
string
UserSelectDefaultValue
object
2 properties 2 required
InteractionCallbackTypes
integer
PongInteractionCallbackRequest
object
1 property 1 required
ErrorResponse
object
Errors object returned by the Discord API
RichEmbedAuthor
object
3 properties
ErrorDetails
CreateMessageInteractionCallbackRequest
object
2 properties 1 required
ApplicationCommandOptionStringChoice
object
3 properties 2 required
InteractionApplicationCommandAutocompleteCallbackStringData
object
1 property
SnowflakeType
string
UserSelect
object
7 properties 2 required
TextStyleTypes
integer
IncomingWebhookUpdateForInteractionCallbackRequestPartial
object
6 properties
ActionRow
object
2 properties 2 required
InnerErrors
object
1 property 1 required
RichEmbedFooter
object
2 properties
ModalInteractionCallbackRequest
object
2 properties 2 required
ModalInteractionCallbackData
object
3 properties 3 required
ChannelSelect
object
8 properties 2 required
MentionableSelect
object
7 properties 2 required
IncomingWebhookInteractionRequest
object
7 properties
RoleSelect
object
7 properties 2 required
ButtonStyleTypes
integer
RichEmbedProvider
object
2 properties
AllowedMentionTypes
string
RichEmbedImage
object
5 properties
SelectOption
object
5 properties 2 required
Error
object
A single error, either for an API response or a specific field.
2 properties 2 required
RoleSelectDefaultValue
object
2 properties 2 required
ChannelTypes
integer

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

discord-interactions-api-openapi.yml Raw ↑

Other APIs Discord publishes across the network.

Discord Gateway API
Discord OAuth2 API
Discord Webhook Events API
Discord Embedded App SDK
Discord Voice API
Discord Social SDK
Discord Application Commands API
Discord Applications API
Discord Audit Log API
Discord Auto Moderation API
Discord Channels API
Discord Emojis API
Where this information came from

This is an independent, third-party profile of Discord Interactions API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.