Bot user
Direct messages, bot status, presence and external users.
Set bot presence
Updates the bot's online status and activity.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Status | Presence status | Yes | Online status to display. Default: Online. |
| Activity type | Activity type | No | Type of activity to show. |
| Activity text | Text | No | Text shown after the activity verb. Maximum length: 128 characters. Shown when Activity type is Playing, Streaming, Listening, Watching, Custom status, Competing. |
| Stream URL | URL | No | Twitch / YouTube URL (streaming activity only). Shown when Activity type is. |
Set bot username
Change the bot's global username.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| New username | Text | Yes | The new global username (2-32 chars). Length: 2 to 32 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Bot user | User | The updated bot user. |
Set bot avatar
Change or remove the bot's global avatar.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Avatar URL | URL | Yes | URL of the new avatar image, or empty to remove. |
Outputs
| Name | Type | Details |
|---|---|---|
| Bot user | User | The updated bot user. |
Set bot banner
Change or remove the bot's profile banner.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Banner URL | URL | Yes | URL of the new banner image, or empty to remove. |
Outputs
| Name | Type | Details |
|---|---|---|
| Bot user | User | The updated bot user. |
Fetch bot user (fresh from Discord)
Requests the bot's own user account from Discord, so the data is always current. Costs one API request, counts toward the rate limit and can fail - use the cached version if you do not need fresh data.
Outputs
| Name | Type | Details |
|---|---|---|
| Bot user | User | The bot's user account, freshly fetched from Discord. |
Fetch application
Fetches the bot's own Discord application, including all public metadata.
Outputs
| Name | Type | Details |
|---|---|---|
| Application | Application | The bot's Discord application. |
Edit application
Edits settings of the bot's Discord application.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Custom Install URL | URL | No | Custom URL Discord redirects users to for installing the app. |
| Description | Text | No | New description for the application. |
| Role Connections Verification URL | URL | No | URL Discord opens to verify role connections. |
| Install Parameters | Application install parameters | No | Default in-app authorization parameters. |
| Flags | List of Application flag | No | Application flags to set (only some flags are settable). |
| Icon | URL | No | URL of the new icon image. |
| Cover Image | URL | No | URL of the new cover image. |
| Interactions Endpoint URL | URL | No | URL Discord sends interactions to instead of the gateway. |
| Tags | List of Text | No | Up to 5 tags describing the application (each at most 20 chars). Maximum length: 20 characters. Maximum items: 5. |
Outputs
| Name | Type | Details |
|---|---|---|
| Application | Application | The updated application. |
Fetch application role connection metadata
Fetches the role-connection metadata entries currently registered for the application.
Outputs
| Name | Type | Details |
|---|---|---|
| Entries | List of Role connection metadata | The role connection metadata entries currently registered. |
Update application role connection metadata
Replaces the role-connection metadata entries registered for the application (max 5).
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Entries | List of Role connection metadata | Yes | Up to five metadata entries to register for the application. Maximum items: 5. |
Outputs
| Name | Type | Details |
|---|---|---|
| Entries | List of Role connection metadata | The metadata entries as stored after the update. |
Update user role connection
Updates the application's role connection for a specific user (platform name, username, and metadata values).
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| User | User | Yes | The user whose role connection to update. |
| Platform Name | Text | No | Name of the connected platform shown in Discord (max 50 chars). Maximum length: 50 characters. |
| Platform Username | Text | No | User's name on the connected platform (max 100 chars). Maximum length: 100 characters. |
| Metadata | Lookup table of Text to Text | No | Lookup table of metadata keys to text values reported to Discord. |
Outputs
| Name | Type | Details |
|---|---|---|
| Success | Yes/No | Whether the update was applied successfully. |
Fetch bot user (from cache, no API call)
Returns the bot's own user account from the local cache. Instant and free, with no API request, but the username, avatar or banner can be briefly out of date right after a change.
Outputs
| Name | Type | Details |
|---|---|---|
| Bot user | User | The bot's user account, read from the cache. |
Fetch bot as server member
Returns the bot resolved as a member of the given server.
Outputs
| Name | Type | Details |
|---|---|---|
| Bot member | Server member | The bot's server membership. |