Discord API Request

The Discord API Request block calls an endpoint of the Discord API as your bot. Use it for things no other block does yet, like listing the messages of a channel.

Pick the endpoint from the list and fill in its parameters. Kite adds your bot's token to the request, so never paste the token into a flow. Endpoints are named after Discord's OpenAPI spec, which sometimes differs from the docs: Modify Guild is update_guild and Get Channel Messages is list_messages.

Placeholders work in the parameters and in the string values of the JSON body. A value that is only a placeholder keeps its type, so "limit": "{{ 5 }}" sends the number 5. To send it as text instead, use {{ string(5) }}.

The block's result is the JSON the endpoint returns, so you can read its fields directly, e.g. {{ result('list')[0].content }} for the first message of List Messages. A request that Discord rejects fails the block with Discord's error message.

Some endpoints aren't available because Kite manages what they change or they don't use the bot's token: changing the bot's name and avatar, the app's commands, emojis and settings, responding to interactions and webhooks that use a token. File uploads aren't supported.

Loading...