LIST GUILD ROLES
This endpoint retrieves a list of roles for a guild identified by `guild_id`.
Each role includes details such as id, name, permissions, and appearance
settings. Responds with role information
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_LIST_GUILD_ROLES])
CREATE GUILD ROLE
This text outlines the process for creating a guild role through Discord's
API, specifying required fields such as name and permissions, and optional
ones like icon. It returns role details or
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_CREATE_GUILD_ROLE])
PREVIEW PRUNE GUILD
The `/guilds/{guild_id}/prune` endpoint previews the count of inactive guild
members eligible for pruning, based on inactivity within 1-30 days and optional
role exclusions.
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_PREVIEW_PRUNE_GUILD])
PRUNE GUILD
The `/guilds/{guild_id}/prune` endpoint prunes inactive guild members within
1-30 days and can compute prune counts and include roles in the check, returning
the number pruned or errors.
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_PRUNE_GUILD])
GET GUILD BAN
"Gets info on a banned user from a guild by ID. Returns user details like
id, username, and ban reason. Handles 200 responses and client errors under
4XX."
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_GET_GUILD_BAN])
BAN USER FROM GUILD
The `/guilds/{guild_id}/bans/{user_id}` endpoint bans a user from a guild,
allowing message deletion timing as seconds (0-604800) or days (0-7). It
returns 204 on success or a 4XX error. Secur
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_BAN_USER_FROM_GUILD])
UNBAN USER FROM GUILD
This endpoint, `/guilds/{guild_id}/bans/{user_id}`, allows for unbanning
a user from a guild. On success, it returns a 204 response. If an error
occurs, a client error response is issued, deta
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_UNBAN_USER_FROM_GUILD])
LIST GUILD BANS
This endpoint lists bans in a guild. Parameters: 'limit' (1-1000), 'before',
'after' (snowflake format). Returns user ban info including ID, username,
and reason. Supports pagination through '
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_LIST_GUILD_BANS])
GET STAGE INSTANCE
This endpoint retrieves details of a specific stage instance by channel
ID, including guild ID, topic, privacy level, and associated event ID. Returns
stage instance info in JSON format and ha
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_GET_STAGE_INSTANCE])
DELETE STAGE INSTANCE
This endpoint deletes a stage instance using a `channel_id`, returning a
204 status for success or a 4XX error with detailed messages and Discord
error codes. Security is BotToken.
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_DELETE_STAGE_INSTANCE])
GET APPLICATION
This endpoint retrieves application details by ID, including its name, icon,
description, bot details, and other specific attributes. Returns data in
JSON, with potential client error response
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_GET_APPLICATION])
UPDATE APPLICATION
Endpoint allows updating application details, including description, icons,
team ID, flags, interaction URLs, and more. Supports patching application
JSON data, with responses for successful u
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_UPDATE_APPLICATION])
GET WEBHOOK BY TOKEN
This endpoint retrieves a webhook by its ID and token, returning a JSON
response with webhook details including application ID, avatar, channel
and guild IDs, name, type, user information, and
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_GET_WEBHOOK_BY_TOKEN])
EXECUTE WEBHOOK
The `/webhooks` endpoint enables sending messages and data with options,
supporting up to 2000 characters and customization. Errors offer detailed
debug information.
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_EXECUTE_WEBHOOK])
DELETE WEBHOOK BY TOKEN
This endpoint allows for deleting a webhook using its ID and token, responding
with 204 upon success or a detailed error object for client errors (4XX).
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_DELETE_WEBHOOK_BY_TOKEN])
UPDATE WEBHOOK BY TOKEN
This API endpoint updates a webhook's name and avatar, returning details
like application ID and type for successful updates, and emits client error
responses for failures.
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_UPDATE_WEBHOOK_BY_TOKEN])
GET STICKER
Fetches details for a specific sticker by ID, supporting both types: STANDARD
(official/Nitro) and GUILD (guild-exclusive). Responses may include sticker
format (PNG/APNG/LOTTIE/GIF), availabi
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_GET_STICKER])
GET WEBHOOK
Fetches details about a specific webhook by its ID, highlighting possible
webhook types. Returns either webhook info or error messages for client
errors.
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_GET_WEBHOOK])
DELETE WEBHOOK
This endpoint removes a specified webhook using its ID, yielding a 204 status
if successful. If it fails, a detailed error message and code are provided.
Execution needs a BotToken for securit
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_DELETE_WEBHOOK])
UPDATE WEBHOOK
This endpoint modifies a webhook's name, avatar, and channel ID, requiring
specific formats and a `BotToy539324699079` token for authentication. It
accepts strings/null for the avatar and prov
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_UPDATE_WEBHOOK])
GET CHANNEL
This GET endpoint fetches a channel by ID, supporting diverse types like
direct messages and guild channels, providing details like message history.
Errors return with descriptive codes/messag
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_GET_CHANNEL])
DELETE CHANNEL
This API endpoint deletes a channel using `{channel_id}`, returning a `200`
and JSON structure based on channel type. It identifies client errors with
`4XX` codes for issues like invalid input
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_DELETE_CHANNEL])
UPDATE CHANNEL
This patch endpoint updates a channel's details, supporting modification
of properties like name, icon, type, position, and more, with detailed schema
for error handling.
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_UPDATE_CHANNEL])
INVITE RESOLVE
This API endpoint fetches details of an invite by code, possibly including
counts and guild event info, based on query parameters. It returns invite
type, code, inviter, expiration, guild/chan
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_INVITE_RESOLVE])
INVITE REVOKE
This endpoint cancels an invite using a unique code for entities like guilds
or channels, returning JSON details like invite type and inviter info. It
requires BotToken authentication and issu
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_INVITE_REVOKE])
GET GUILD
Retrieve guild details including ID, name, icon, and features. Supports
query parameter `with_counts` for member and presence counts. ApiResponse
includes guild properties, roles, emojis, and
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_GET_GUILD])
DELETE GUILD
This endpoint deletes a guild by ID, returning a 204 on success. Client
errors yield detailed error messages with codes. A BotToken is needed for
security.
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_DELETE_GUILD])
UPDATE GUILD
This PATCH endpoint updates guild settings like name, region, and more,
returning updated details or structured errors upon failure.
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_UPDATE_GUILD])
GETUSER
Fetch a user's details by their user_id. Responds with user info including
id, username, and various optional fields like avatar, bot status. Handles
errors with detailed messages. Requires Bo
from composio_openai import ComposioToolSet, Action
tool_set = ComposioToolSet()
tools = tool_set.get_tools(actions=[Action.DISCORD_GETUSER])