The Applications API from Discord — 12 operation(s) for applications.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/discord-applications-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Discord Interactions Application Commands Applications API
description: 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.
version: '10'
contact:
name: Discord Support
url: https://support-dev.discord.com/hc/en-us
email: support@discord.com
termsOfService: https://discord.com/developers/docs/policies-and-agreements/developer-terms-of-service
servers:
- url: https://discord.com/api/v10
description: Discord API v10
security:
- BotToken: []
tags:
- name: Applications
paths:
/applications/@me:
get:
operationId: get_my_application
responses:
'200':
description: 200 response for get_my_application
content:
application/json:
schema:
$ref: '#/components/schemas/PrivateApplicationResponse'
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
tags:
- Applications
patch:
operationId: update_my_application
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationFormPartial'
required: true
responses:
'200':
description: 200 response for update_my_application
content:
application/json:
schema:
$ref: '#/components/schemas/PrivateApplicationResponse'
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
tags:
- Applications
/applications/{application_id}/guilds/{guild_id}/commands/permissions:
parameters:
- name: application_id
in: path
schema:
$ref: '#/components/schemas/SnowflakeType'
required: true
- name: guild_id
in: path
schema:
$ref: '#/components/schemas/SnowflakeType'
required: true
get:
operationId: list_guild_application_command_permissions
responses:
'200':
description: 200 response for list_guild_application_command_permissions
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/CommandPermissionsResponse'
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
- OAuth2:
- applications.commands.permissions.update
tags:
- Applications
/applications/{application_id}/guilds/{guild_id}/commands/{command_id}/permissions:
parameters:
- name: application_id
in: path
schema:
$ref: '#/components/schemas/SnowflakeType'
required: true
- name: guild_id
in: path
schema:
$ref: '#/components/schemas/SnowflakeType'
required: true
- name: command_id
in: path
schema:
$ref: '#/components/schemas/SnowflakeType'
required: true
get:
operationId: get_guild_application_command_permissions
responses:
'200':
description: 200 response for get_guild_application_command_permissions
content:
application/json:
schema:
$ref: '#/components/schemas/CommandPermissionsResponse'
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
- OAuth2:
- applications.commands.permissions.update
tags:
- Applications
put:
operationId: set_guild_application_command_permissions
requestBody:
content:
application/json:
schema:
type: object
properties:
permissions:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ApplicationCommandPermission'
maxItems: 100
required: true
responses:
'200':
description: 200 response for set_guild_application_command_permissions
content:
application/json:
schema:
$ref: '#/components/schemas/CommandPermissionsResponse'
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
- OAuth2:
- applications.commands.permissions.update
tags:
- Applications
/applications/{application_id}/role-connections/metadata:
parameters:
- name: application_id
in: path
schema:
$ref: '#/components/schemas/SnowflakeType'
required: true
get:
operationId: get_application_role_connections_metadata
responses:
'200':
description: 200 response for get_application_role_connections_metadata
content:
application/json:
schema:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ApplicationRoleConnectionsMetadataItemResponse'
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
tags:
- Applications
put:
operationId: update_application_role_connections_metadata
requestBody:
content:
application/json:
schema:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ApplicationRoleConnectionsMetadataItemRequest'
maxItems: 5
required: true
responses:
'200':
description: 200 response for update_application_role_connections_metadata
content:
application/json:
schema:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ApplicationRoleConnectionsMetadataItemResponse'
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
tags:
- Applications
/applications/{application_id}/entitlements/{entitlement_id}/consume:
parameters:
- name: application_id
in: path
schema:
$ref: '#/components/schemas/SnowflakeType'
required: true
- name: entitlement_id
in: path
schema:
$ref: '#/components/schemas/SnowflakeType'
required: true
post:
operationId: consume_entitlement
responses:
'204':
description: 204 response for consume_entitlement
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
- OAuth2:
- applications.entitlements
tags:
- Applications
/applications/{application_id}/guilds/{guild_id}/commands/{command_id}:
parameters:
- name: application_id
in: path
schema:
$ref: '#/components/schemas/SnowflakeType'
required: true
- name: guild_id
in: path
schema:
$ref: '#/components/schemas/SnowflakeType'
required: true
- name: command_id
in: path
schema:
$ref: '#/components/schemas/SnowflakeType'
required: true
get:
operationId: get_guild_application_command
responses:
'200':
description: 200 response for get_guild_application_command
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationCommandResponse'
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
- OAuth2:
- applications.commands.update
tags:
- Applications
delete:
operationId: delete_guild_application_command
responses:
'204':
description: 204 response for delete_guild_application_command
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
- OAuth2:
- applications.commands.update
tags:
- Applications
patch:
operationId: update_guild_application_command
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationCommandPatchRequestPartial'
required: true
responses:
'200':
description: 200 response for update_guild_application_command
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationCommandResponse'
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
- OAuth2:
- applications.commands.update
tags:
- Applications
/applications/{application_id}/guilds/{guild_id}/commands:
parameters:
- name: application_id
in: path
schema:
$ref: '#/components/schemas/SnowflakeType'
required: true
- name: guild_id
in: path
schema:
$ref: '#/components/schemas/SnowflakeType'
required: true
get:
operationId: list_guild_application_commands
parameters:
- name: with_localizations
in: query
schema:
type: boolean
responses:
'200':
description: 200 response for list_guild_application_commands
content:
application/json:
schema:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ApplicationCommandResponse'
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
- OAuth2:
- applications.commands.update
tags:
- Applications
put:
operationId: bulk_set_guild_application_commands
requestBody:
content:
application/json:
schema:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ApplicationCommandUpdateRequest'
maxItems: 110
required: true
responses:
'200':
description: 200 response for bulk_set_guild_application_commands
content:
application/json:
schema:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ApplicationCommandResponse'
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
- OAuth2:
- applications.commands.update
tags:
- Applications
post:
operationId: create_guild_application_command
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationCommandCreateRequest'
required: true
responses:
'200':
description: 200 response for create_guild_application_command
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationCommandResponse'
'201':
description: 201 response for create_guild_application_command
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationCommandResponse'
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
- OAuth2:
- applications.commands.update
tags:
- Applications
/applications/{application_id}/entitlements/{entitlement_id}:
parameters:
- name: application_id
in: path
schema:
$ref: '#/components/schemas/SnowflakeType'
required: true
- name: entitlement_id
in: path
schema:
$ref: '#/components/schemas/SnowflakeType'
required: true
get:
operationId: get_entitlement
responses:
'200':
description: 200 response for get_entitlement
content:
application/json:
schema:
$ref: '#/components/schemas/EntitlementResponse'
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
- OAuth2:
- applications.entitlements
tags:
- Applications
delete:
operationId: delete_entitlement
responses:
'204':
description: 204 response for delete_entitlement
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
- OAuth2:
- applications.entitlements
tags:
- Applications
/applications/{application_id}/entitlements:
parameters:
- name: application_id
in: path
schema:
$ref: '#/components/schemas/SnowflakeType'
required: true
get:
operationId: get_entitlements
parameters:
- name: user_id
in: query
schema:
$ref: '#/components/schemas/SnowflakeType'
- name: sku_ids
in: query
schema:
oneOf:
- type: string
- type: array
items:
oneOf:
- type: 'null'
- $ref: '#/components/schemas/SnowflakeType'
maxItems: 100
uniqueItems: true
required: true
- name: guild_id
in: query
schema:
$ref: '#/components/schemas/SnowflakeType'
- name: before
in: query
schema:
$ref: '#/components/schemas/SnowflakeType'
- name: after
in: query
schema:
$ref: '#/components/schemas/SnowflakeType'
- name: limit
in: query
schema:
type: integer
minimum: 1
maximum: 100
- name: exclude_ended
in: query
schema:
type: boolean
- name: only_active
in: query
schema:
type: boolean
responses:
'200':
description: 200 response for get_entitlements
content:
application/json:
schema:
type: array
items:
oneOf:
- type: 'null'
- $ref: '#/components/schemas/EntitlementResponse'
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
- OAuth2:
- applications.entitlements
tags:
- Applications
post:
operationId: create_entitlement
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateEntitlementRequestData'
required: true
responses:
'200':
description: 200 response for create_entitlement
content:
application/json:
schema:
$ref: '#/components/schemas/EntitlementResponse'
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
tags:
- Applications
/applications/{application_id}/commands/{command_id}:
parameters:
- name: application_id
in: path
schema:
$ref: '#/components/schemas/SnowflakeType'
required: true
- name: command_id
in: path
schema:
$ref: '#/components/schemas/SnowflakeType'
required: true
get:
operationId: get_application_command
responses:
'200':
description: 200 response for get_application_command
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationCommandResponse'
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
- OAuth2:
- applications.commands.update
tags:
- Applications
delete:
operationId: delete_application_command
responses:
'204':
description: 204 response for delete_application_command
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
- OAuth2:
- applications.commands.update
tags:
- Applications
patch:
operationId: update_application_command
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationCommandPatchRequestPartial'
required: true
responses:
'200':
description: 200 response for update_application_command
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationCommandResponse'
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
- OAuth2:
- applications.commands.update
tags:
- Applications
/applications/{application_id}/commands:
parameters:
- name: application_id
in: path
schema:
$ref: '#/components/schemas/SnowflakeType'
required: true
get:
operationId: list_application_commands
parameters:
- name: with_localizations
in: query
schema:
type: boolean
responses:
'200':
description: 200 response for list_application_commands
content:
application/json:
schema:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ApplicationCommandResponse'
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
- OAuth2:
- applications.commands.update
tags:
- Applications
put:
operationId: bulk_set_application_commands
requestBody:
content:
application/json:
schema:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ApplicationCommandUpdateRequest'
maxItems: 110
required: true
responses:
'200':
description: 200 response for bulk_set_application_commands
content:
application/json:
schema:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ApplicationCommandResponse'
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
- OAuth2:
- applications.commands.update
tags:
- Applications
post:
operationId: create_application_command
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationCommandCreateRequest'
required: true
responses:
'200':
description: 200 response for create_application_command
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationCommandResponse'
'201':
description: 201 response for create_application_command
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationCommandResponse'
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
- OAuth2:
- applications.commands.update
tags:
- Applications
/applications/{application_id}:
parameters:
- name: application_id
in: path
schema:
$ref: '#/components/schemas/SnowflakeType'
required: true
get:
operationId: get_application
responses:
'200':
description: 200 response for get_application
content:
application/json:
schema:
$ref: '#/components/schemas/PrivateApplicationResponse'
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
tags:
- Applications
patch:
operationId: update_application
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationFormPartial'
required: true
responses:
'200':
description: 200 response for update_application
content:
application/json:
schema:
$ref: '#/components/schemas/PrivateApplicationResponse'
4XX:
$ref: '#/components/responses/ClientErrorResponse'
security:
- BotToken: []
tags:
- Applications
components:
schemas:
EntitlementOwnerTypes:
type: integer
oneOf: []
format: int32
ApplicationCommandRoleOption:
type: object
properties:
type:
type: integer
enum:
- 8
allOf:
- $ref: '#/components/schemas/ApplicationCommandOptionType'
format: int32
name:
type: string
minLength: 1
maxLength: 32
name_localizations:
type:
- object
- 'null'
additionalProperties:
type: string
minLength: 1
maxLength: 32
maxProperties: 34
description:
type: string
minLength: 1
maxLength: 100
description_localizations:
type:
- object
- 'null'
additionalProperties:
type: string
minLength: 1
maxLength: 100
maxProperties: 34
required:
type:
- boolean
- 'null'
required:
- type
- name
- description
ErrorDetails:
oneOf:
- type: object
additionalProperties:
$ref: '#/components/schemas/ErrorDetails'
- $ref: '#/components/schemas/InnerErrors'
ApplicationCommandPermissionType:
type: integer
oneOf:
- title: ROLE
description: This permission is for a role.
const: 1
- title: USER
description: This permission is for a user.
const: 2
- title: CHANNEL
description: This permission is for a channel.
const: 3
format: int32
ApplicationCommandPermission:
type: object
properties:
id:
$ref: '#/components/schemas/SnowflakeType'
type:
$ref: '#/components/schemas/ApplicationCommandPermissionType'
permission:
type: boolean
required:
- id
- type
- permission
CreateEntitlementRequestData:
type: object
properties:
sku_id:
$ref: '#/components/schemas/SnowflakeType'
owner_id:
$ref: '#/components/schemas/SnowflakeType'
owner_type:
$ref: '#/components/schemas/EntitlementOwnerTypes'
required:
- sku_id
- owner_id
- owner_type
ApplicationCommandNumberOption:
type: object
properties:
type:
type: integer
enum:
- 10
allOf:
- $ref: '#/components/schemas/ApplicationCommandOptionType'
format: int32
name:
type: string
minLength: 1
maxLength: 32
name_localizations:
type:
- object
- 'null'
additionalProperties:
type: string
minLength: 1
maxLength: 32
maxProperties: 34
description:
type: string
minLength: 1
maxLength: 100
description_localizations:
type:
- object
- 'null'
additionalProperties:
type: string
minLength: 1
maxLength: 100
maxProperties: 34
required:
type:
- boolean
- 'null'
autocomplete:
type:
- boolean
- 'null'
choices:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ApplicationCommandOptionNumberChoice'
maxItems: 25
min_value:
type:
- number
- 'null'
format: double
max_value:
type:
- number
- 'null'
format: double
required:
- type
- name
- description
CommandPermissionResponse:
type: object
properties:
id:
$ref: '#/components/schemas/SnowflakeType'
type:
$ref: '#/components/schemas/ApplicationCommandPermissionType'
permission:
type: boolean
required:
- id
- type
- permission
InnerErrors:
type: object
properties:
_errors:
type: array
description: The list of errors for this field
items:
$ref: '#/components/schemas/Error'
additionalProperties: false
required:
- _errors
ApplicationCommandSubcommandGroupOptionResponse:
type: object
properties:
type:
type: integer
enum:
- 2
allOf:
- $ref: '#/components/schemas/ApplicationCommandOptionType'
format: int32
name:
type: string
name_localized:
type:
- string
- 'null'
name_localizations:
type:
- object
- 'null'
additionalProperties:
type: string
description:
type: string
description_localized:
type:
- string
- 'null'
description_localizations:
type:
- object
- 'null'
additionalProperties:
type: string
required:
type:
- boolean
- 'null'
options:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ApplicationCommandSubcommandOptionResponse'
required:
- type
- name
- description
ApplicationCommandType:
type: integer
oneOf:
- title: CHAT
description: Slash commands; a text-based command that shows up when a user types /
const: 1
- title: USER
description: A UI-based command that shows up when you right click or tap on a user
const: 2
- title: MESSAGE
description: A UI-based command that shows up when you right click or tap on a message
const: 3
format: int32
ApplicationCommandCreateRequest:
type: object
properties:
name:
type: string
minLength: 1
maxLength: 32
name_localizations:
type:
- object
- 'null'
additionalProperties:
type: string
minLength: 1
maxLength: 32
maxProperties: 34
description:
type:
- string
- 'null'
maxLength: 100
description_localizations:
type:
- object
- 'null'
additionalProperties:
type: string
minLength: 1
maxLength: 100
maxProperties: 34
options:
type:
- array
- 'null'
items:
oneOf:
- $ref: '#/components/schemas/ApplicationCommandAttachmentOption'
- $ref: '#/components/schemas/ApplicationCommandBooleanOption'
- $ref: '#/components/schemas/ApplicationCommandChannelOption'
- $ref: '#/components/schemas/ApplicationCommandIntegerOption'
- $ref: '#/components/schemas/ApplicationCommandMentionableOption'
- $ref: '#/components/schemas/ApplicationCommandNumberOption'
- $ref: '#/components/schemas/ApplicationCommandRoleOption'
- $ref: '#/components/schemas/ApplicationCommandStringOption'
- $ref: '#/components/schemas/ApplicationCommandSubcommandGroupOption'
- $ref: '#/components/schemas/ApplicationCommandSubcommandOption'
- $ref: '#/components/schemas/ApplicationCommandUserOption'
maxItems: 25
default_member_permissions:
type:
- integer
- 'null'
minimum: 0
maximum: 2251799813685247
dm_permission:
type:
- boolean
- 'null'
type:
oneOf:
- type: 'null'
- $ref: '#/components/schemas/ApplicationCommandType'
required:
- name
EntitlementResponse:
type: object
properties:
id:
$ref: '#/components/schemas/SnowflakeType'
sku_id:
$ref: '#/components/schemas/SnowflakeType'
application_id:
$ref: '#/components/schemas/SnowflakeType'
user_id:
$ref: '#/components/schemas/SnowflakeType'
guild_id:
oneOf:
- type: 'null'
- $ref: '#/components/schemas/SnowflakeType'
deleted:
type: boolean
starts_at:
type:
- string
- 'null'
format: date-time
ends_at:
type:
- string
- 'null'
format: date-time
type:
$ref: '#/components/schemas/EntitlementTypes'
fulfilled_at:
type:
- string
- 'null'
format: date-time
fulfillment_status:
oneOf:
- type: 'null'
- $ref: '#/components/schemas/EntitlementTenantFulfillmentStatusResponse'
consumed:
type:
- boolean
- 'null'
required:
- id
- sku_id
- application_id
- user_id
- deleted
- type
ApplicationCommandOptionIntegerChoice:
type: object
properties:
name:
type: string
minLength: 1
maxLength: 100
name_localizations:
type:
- object
- 'null'
additionalProperties:
type: string
minLength: 1
maxLength: 100
maxProperties: 34
value:
$ref: '#/components/schemas/Int53Type'
required:
- name
- value
ApplicationCommandMentionableOptionResponse:
type: object
properties:
type:
type: integer
enum:
- 9
allOf:
- $ref: '#/components/schemas/ApplicationCommandOptionType'
format: int32
name:
type: string
name_localized:
type:
- string
- 'null'
name_localizations:
type:
- object
- 'null'
additionalProperties:
type: string
description:
type: string
description_localized:
type:
- string
- 'null'
description_localizations:
type:
- object
- 'null'
additionalProperties:
type: string
required:
type:
- boolean
- 'null'
required:
- type
- name
- description
ApplicationCommandSubcommandOptionResponse:
type: object
properties:
type:
type: integer
enum:
- 1
allOf:
- $ref: '#/components/schemas/ApplicationCommandOptionType'
format: int32
name:
type: string
name_localized:
type:
- string
- 'null'
name_localizations:
type:
- object
- 'null'
additionalProperties:
type: string
description:
type: string
description_localized:
type:
- string
- 'null'
description_localizations:
type:
- object
- 'null'
additionalProperties:
type: string
required
# --- truncated at 32 KB (82 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/discord/refs/heads/main/openapi/discord-applications-api-openapi.yml