API Categories
Users API
Get Current User
Get your user information
Get information about your Discord account including username, ID, and avatar.
Endpoint
GET /users/@me
Example cURL
curl -X GET "https://discord.com/api/v10/users/@me" \
-H "Authorization: <token>"
Edit Message
Edit your own message content
Edit the content of a message you previously sent. Only works on your own messages.
Endpoint
PATCH /channels/{channel_id}/messages/{message_id}
Payload
{
"content": "Edited message content"
}
Example cURL
curl -X PATCH "https://discord.com/api/v10/channels/123456789/messages/987654321" \
-H "Authorization: <token>" \
-H "Content-Type: application/json" \
-d '{"content": "Edited message content"}'
Delete Message
Delete your own message
Delete a message you previously sent. Only works on your own messages.
Endpoint
DELETE /channels/{channel_id}/messages/{message_id}
Example cURL
curl -X DELETE "https://discord.com/api/v10/channels/123456789/messages/987654321" \
-H "Authorization: <token>"
Get Messages
Retrieve messages from a channel
Get a list of messages from a channel. Maximum limit is 100 messages.
Endpoint
GET /channels/{channel_id}/messages?limit=50
Example cURL
curl -X GET "https://discord.com/api/v10/channels/123456789/messages?limit=50" \
-H "Authorization: <token>"
Messages API
Channels API
Create Channel
Create a new channel in a guild
Create a new channel in a guild. Requires MANAGE_CHANNELS permission.
Endpoint
POST /guilds/{guild_id}/channels
Payload
{
"name": "new-channel",
"type": 0,
"topic": "Channel description",
"nsfw": false
}
Delete Channel
Delete a channel permanently
Delete a channel permanently. This action cannot be undone.
Endpoint
DELETE /channels/{channel_id}
Example cURL
curl -X DELETE "https://discord.com/api/v10/channels/123456789" \
-H "Authorization: <token>"
Guilds API
Get Guild
Retrieve guild information
Get detailed information about a Discord guild including roles, channels, and member count.
Endpoint
GET /guilds/{guild_id}
Example cURL
curl -X GET "https://discord.com/api/v10/guilds/123456789" \
-H "Authorization: <token>"
Get Guild Members
Retrieve guild member list
Get a list of guild members. Maximum limit is 1000 members per request.
Endpoint
GET /guilds/{guild_id}/members?limit=1000
Example cURL
curl -X GET "https://discord.com/api/v10/guilds/123456789/members?limit=1000" \
-H "Authorization: <token>"
Webhooks API
Execute Webhook
Send a message through webhook
Send a message through a Discord webhook. No authentication required.
Endpoint
POST /webhooks/{webhook_id}/{webhook_token}
Payload
{
"content": "Hello from webhook!",
"username": "Webhook Bot",
"avatar_url": "https://example.com/avatar.png"
}
Example cURL
curl -X POST "https://discord.com/api/v10/webhooks/123456789/abcdef" \
-H "Content-Type: application/json" \
-d '{"content": "Hello from webhook!", "username": "Webhook Bot"}'