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 Channels API

The Channels API from Discord — 26 operation(s) for channels.

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

Tagged areas include Channels. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 42 operations across 26 paths, and defines 150 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.

42 operations 26 paths 150 schemas 11 DELETE13 GET2 PATCH10 POST6 PUT

Metadata

The identity and technical contract details declared by the specification.

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

Authentication & Security 1

Discord Channels 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 42

Across 26 paths, the API surfaces 42 operations — 11 DELETE, 13 GET, 2 PATCH, 10 POST, 6 PUT. Each is listed below with its method, path, parameters, and response codes.

Channels 42
GET
/channels/{channel_id}/users/@me/threads/archived/private
list_my_private_archived_threads 3 params → 2004XX
PUT
/channels/{channel_id}/messages/{message_id}/reactions/{emoji_name}/@me
add_my_message_reaction 3 params → 2044XX
DELETE
/channels/{channel_id}/messages/{message_id}/reactions/{emoji_name}/@me
delete_my_message_reaction 3 params → 2044XX
GET
/channels/{channel_id}/threads/archived/private
list_private_archived_threads 3 params → 2004XX
GET
/channels/{channel_id}/threads/archived/public
list_public_archived_threads 3 params → 2004XX
PUT
/channels/{channel_id}/thread-members/@me
join_thread 1 param → 2044XX
DELETE
/channels/{channel_id}/thread-members/@me
leave_thread 1 param → 2044XX
POST
/channels/{channel_id}/messages/bulk-delete
bulk_delete_messages 1 param body → 2044XX
DELETE
/channels/{channel_id}/messages/{message_id}/reactions/{emoji_name}/{user_id}
delete_user_message_reaction 4 params → 2044XX
GET
/channels/{channel_id}/messages/{message_id}/reactions/{emoji_name}
list_message_reactions_by_emoji 5 params → 2004XX
DELETE
/channels/{channel_id}/messages/{message_id}/reactions/{emoji_name}
delete_all_message_reactions_by_emoji 3 params → 2044XX
DELETE
/channels/{channel_id}/messages/{message_id}/reactions
delete_all_message_reactions 2 params → 2044XX
POST
/channels/{channel_id}/messages/{message_id}/crosspost
crosspost_message 2 params → 2004XX
POST
/channels/{channel_id}/messages/{message_id}/threads
create_thread_from_message 2 params body → 2014XX
GET
/channels/{channel_id}/thread-members/{user_id}
get_thread_member 3 params → 2004XX
PUT
/channels/{channel_id}/thread-members/{user_id}
add_thread_member 2 params → 2044XX
DELETE
/channels/{channel_id}/thread-members/{user_id}
delete_thread_member 2 params → 2044XX
GET
/channels/{channel_id}/thread-members
list_thread_members 4 params → 2004XX
PUT
/channels/{channel_id}/permissions/{overwrite_id}
set_channel_permission_overwrite 2 params body → 2044XX
DELETE
/channels/{channel_id}/permissions/{overwrite_id}
delete_channel_permission_overwrite 2 params → 2044XX
PUT
/channels/{channel_id}/recipients/{user_id}
add_group_dm_user 2 params body → 2012044XX
DELETE
/channels/{channel_id}/recipients/{user_id}
delete_group_dm_user 2 params → 2044XX
POST
/channels/{channel_id}/followers
follow_channel 1 param body → 2004XX
GET
/channels/{channel_id}/messages/{message_id}
get_message 2 params → 2004XX
DELETE
/channels/{channel_id}/messages/{message_id}
delete_message 2 params → 2044XX
PATCH
/channels/{channel_id}/messages/{message_id}
update_message 2 params body → 2004XX
GET
/channels/{channel_id}/messages
list_messages 5 params → 2004XX
POST
/channels/{channel_id}/messages
create_message 1 param body → 2004XX
GET
/channels/{channel_id}/webhooks
list_channel_webhooks 1 param → 2004XX
POST
/channels/{channel_id}/webhooks
create_webhook 1 param body → 2004XX
GET
/channels/{channel_id}/invites
list_channel_invites 1 param → 2004XX
POST
/channels/{channel_id}/invites
create_channel_invite 1 param body → 2002044XX
POST
/channels/{channel_id}/threads
create_thread 1 param body → 2014XX
POST
/channels/{channel_id}/typing
trigger_typing_indicator 1 param → 2002044XX
PUT
/channels/{channel_id}/pins/{message_id}
pin_message 2 params → 2044XX
DELETE
/channels/{channel_id}/pins/{message_id}
unpin_message 2 params → 2044XX
GET
/channels/{channel_id}/pins
list_pinned_messages 1 param → 2004XX
GET
/channels/{channel_id}
get_channel 1 param → 2004XX
DELETE
/channels/{channel_id}
delete_channel 1 param → 2004XX
PATCH
/channels/{channel_id}
update_channel 1 param body → 2004XX
GET
/guilds/{guild_id}/channels
Discord List guild channels
getGuildChannels 1 param → 2004XX
POST
/guilds/{guild_id}/channels
Discord Create guild channel
createGuildChannel 1 param body → 2014XX

Schemas 150

The contract defines 150 schemas that model the data the API accepts and returns. The most detailed are MessageResponse (34 properties), BasicMessageResponse (32 properties), Channel (25 properties), GuildChannelResponse (24 properties). Each schema is shown below with its type and property counts.

MessageReactionCountDetailsResponse
object
2 properties 2 required
Int53Type
integer
ApplicationTypes
integer
ChannelFollowerResponse
object
2 properties 2 required
MessageRoleSubscriptionDataResponse
object
4 properties 4 required
InputText
object
9 properties 4 required
ChannelSelectDefaultValue
object
2 properties 2 required
StringSelect
object
7 properties 3 required
ApplicationResponse
object
21 properties 5 required
ChannelFollowerWebhookResponse
object
10 properties 3 required
Button
object
8 properties 2 required
MessageComponentRoleSelectResponse
object
7 properties 3 required
RichEmbedVideo
object
5 properties
StickerFormatTypes
integer
ChannelPermissionOverwriteRequest
object
4 properties 1 required
InviteApplicationResponse
object
21 properties 5 required
MessageEmbedVideoResponse
object
6 properties
MessageEditRequestPartial
object
7 properties
MessageCreateRequest
object
10 properties
ThreadMetadataResponse
object
6 properties 3 required
Overwrite
object
4 properties
CreateChannelRequest
object
13 properties 1 required
GroupDMInviteResponse
object
8 properties 1 required
Channel
object
25 properties 2 required
SnowflakeType
string
StickerTypes
integer
ResolvedObjectsResponse
object
4 properties 4 required
BasicApplicationResponse
object
8 properties 3 required
MessageEmbedFooterResponse
object
3 properties 1 required
MessageEmbedImageResponse
object
6 properties
MessageComponentStringSelectResponse
object
8 properties 3 required
CreateTextThreadWithoutMessageRequest
object
5 properties 1 required
User
object
17 properties 2 required
PurchaseNotificationResponse
object
2 properties 1 required
Error
object
A single error, either for an API response or a specific field.
2 properties 2 required
MessageCallResponse
object
2 properties 1 required
PrivateChannelRequestPartial
object
2 properties
InviteChannelRecipientResponse
object
1 property 1 required
GuildScheduledEventStatuses
integer
CreatedThreadResponse
object
21 properties 9 required
UserResponse
object
11 properties 5 required
StandardStickerResponse
object
8 properties 6 required
ChannelPermissionOverwrites
integer
ThreadsResponse
object
3 properties 2 required
SnowflakeSelectDefaultValueTypes
string
GuildChannelResponse
object
24 properties 6 required
UpdateThreadRequestPartial
object
12 properties
PrivateChannelResponse
object
6 properties 4 required
WebhookSourceGuildResponse
object
3 properties 2 required
MessageReferenceResponse
object
4 properties 1 required
UserSelect
object
7 properties 2 required
UInt32Type
integer
RichEmbedFooter
object
2 properties
ScheduledEventUserResponse
object
4 properties 2 required
MessageEmbedResponse
object
13 properties 1 required
GuildRoleResponse
object
12 properties 8 required
CreateGuildInviteRequest
object
7 properties
ThreadSortOrder
integer
RichEmbedImage
object
5 properties
GuildMemberResponse
object
12 properties 7 required
UpdateGuildChannelRequestPartial
object
19 properties
Snowflake
string
Discord unique ID represented as a string
CreateForumThreadRequest
object
5 properties 2 required
RoleSelectDefaultValue
object
2 properties 2 required
SelectOption
object
5 properties 2 required
RichEmbedField
object
3 properties 2 required
DefaultReactionEmojiResponse
object
2 properties
ThreadAutoArchiveDuration
integer
MessageComponentInputTextResponse
object
10 properties 4 required
CreateGroupDMInviteRequest
object
1 property
FriendInviteResponse
object
12 properties 1 required
CreateTextThreadWithMessageRequest
object
3 properties 1 required
OAuth2Scopes
string
VideoQualityModes
integer
MessageResponse
object
34 properties 15 required
InviteTargetTypes
integer
ForumTagResponse
object
5 properties 3 required
VerificationLevels
integer
MessageComponentChannelSelectResponse
object
8 properties 3 required
MessageComponentTypes
integer
InviteTypes
integer
GuildScheduledEventEntityTypes
integer
UserSelectDefaultValue
object
2 properties 2 required
MessageAttachmentResponse
object
16 properties 5 required
ChannelPermissionOverwriteResponse
object
4 properties 4 required
MessageEmbedFieldResponse
object
3 properties 3 required
MessageMentionChannelResponse
object
4 properties 4 required
RichEmbedAuthor
object
3 properties
MessageComponentMentionableSelectResponse
object
7 properties 3 required
ErrorDetails
ThreadMemberResponse
object
5 properties 4 required
MessageReferenceType
integer
InteractionTypes
integer
GuildRoleTagsResponse
object
6 properties
TextStyleTypes
integer
MessageActivityResponse
object
ThreadResponse
object
21 properties 9 required
MessageComponentEmojiResponse
object
3 properties 1 required
MessageType
integer
GuildStickerResponse
object
9 properties 6 required
ActionRow
object
2 properties 2 required
InnerErrors
object
1 property 1 required
InviteGuildResponse
object
12 properties 3 required
ChannelSelect
object
8 properties 2 required
MentionableSelect
object
7 properties 2 required
GuildFeatures
string
RichEmbedProvider
object
2 properties
ButtonStyleTypes
integer
MessageReactionEmojiResponse
object
3 properties
AllowedMentionTypes
string
GuildNSFWContentLevel
integer
ApplicationOAuth2InstallParamsResponse
object
2 properties 2 required
InviteStageInstanceResponse
object
4 properties 1 required
PrivateGroupChannelResponse
object
11 properties 4 required
UpdateThreadTagRequest
object
5 properties 1 required
MessageComponentButtonResponse
object
8 properties 3 required
UserAvatarDecorationResponse
object
ThreadMetadata
object
6 properties
MessageComponentActionRowResponse
object
3 properties 2 required
MessageAttachmentRequest
object
4 properties 1 required
MessageAllowedMentionsRequest
object
4 properties
MessageStickerItemResponse
object
3 properties 3 required
WebhookTypes
integer
Emoji
object
3 properties 1 required
RichEmbed
object
13 properties
TypingIndicatorResponse
object
RichEmbedThumbnail
object
5 properties
MessageEmbedAuthorResponse
object
4 properties 1 required
MessageEmbedProviderResponse
object
2 properties 1 required
BasicMessageResponse
object
32 properties 15 required
ForumLayout
integer
GuildProductPurchaseResponse
object
2 properties 2 required
ErrorResponse
object
Errors object returned by the Discord API
UpdateDefaultReactionEmojiRequest
object
2 properties
SelectOptionResponse
object
5 properties 2 required
GuildInviteResponse
object
21 properties 1 required
MessageReferenceRequest
object
5 properties 1 required
ApplicationIncomingWebhookResponse
object
8 properties 3 required
InviteChannelResponse
object
5 properties 2 required
ScheduledEventResponse
object
16 properties 7 required
PurchaseType
integer
MessageInteractionResponse
object
5 properties 3 required
BaseCreateMessageCreateRequest
object
7 properties
WebhookSourceChannelResponse
object
2 properties 2 required
RoleSelect
object
7 properties 2 required
MessageComponentUserSelectResponse
object
7 properties 3 required
GuildIncomingWebhookResponse
object
10 properties 3 required
MessageReactionResponse
object
6 properties 6 required
GuildScheduledEventPrivacyLevels
integer
ChannelTypes
integer

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

discord-channels-api-openapi.yml Raw ↑

Other APIs Discord publishes across the network.

Discord Gateway API
Discord Interactions 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 Emojis API
Where this information came from

This is an independent, third-party profile of Discord Channels 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.