BDFD API

Public Bot Designer for Discord API.

API

Our API domain:

https://botdesignerdiscord.com/public/api

Endpoints

GET /function_list

Returns an array of function.

https://botdesignerdiscord.com/public/api/function_list

Response Example - 200

[
      ...,
      {
        "tag": "$aiQuota",
        "shortDescription": "Get remaining AI quota for this bot",
        "longDescription": "",
        "arguments": null,
        "intents": 0,
        "premium": true,
        "color": 0
    }, ... 
]

GET /callback_list

Returns an array of callback.

https://botdesignerdiscord.com/public/api/callback_list

Response Example - 200

[
      ...,
      {
        "name": "$onMessageDelete[channel ID]",
        "description": "Triggers command when user deletes message",
        "arguments": [
            {
                "name": "Channel ID",
                "description": "Channel ID of the log channel",
                "type": "Snowflake",
                "required": true
            }
        ],
        "intents": 0,
        "is_premium": false
    }, ... 
]

GET /function_tag_list

Returns an array of function tags.

https://botdesignerdiscord.com/public/api/function_tag_list

Response Example - 200

[
    "$addButton[]",
    "$addCmdReactions[]",
    "$addEmoji[]",
    "$addField[]",
    "$addMessageReactions[]",
    "$addReactions[]",
    "$addSelectMenuOption[]",
    "$addTextInput[]",
    "$addTimestamp",
    "$addTimestamp[]",
    "$aiQuota", 
    ... 
]

GET /callback_tag_list

Returns an array of callback tags.

https://botdesignerdiscord.com/public/api/callback_tag_list

Response Example - 200

[
    "$onJoined[]",
    "$onLeave[]",
    "$onMessageDelete[]",
    "$onBanAdd[]",
    "$onBanRemove[]",
    "$alwaysReply",
    "$messageContains[]",
    "$awaitedCommand[]",
    "$reaction[]",
    "$onInteraction[]",
    "$onInteraction"
]

GET /function/:function

Returns a function.

https://botdesignerdiscord.com/public/api/function/$c[]

Response Example - 200

{
    "tag": "$c[Comment]",
    "shortDescription": "Can be used to comment your code.",
    "longDescription": "",
    "arguments": [
        {
            "name": "Comment",
            "type": "String",
            "required": true,
            "empty": true
        }
    ],
    "intents": 0,
    "premium": false,
    "color": 0
}

GET /callback/:callback

Returns an array of callback tags.

https://botdesignerdiscord.com/public/api/callback/$onJoined[]

Response Example - 200

{
    "name": "$onJoined[channel ID]",
    "description": "Triggers command when user joins server",
    "arguments": [
        {
            "name": "Channel ID",
            "description": "Channel ID of the welcome channel",
            "type": "Snowflake",
            "required": true
        }
    ],
    "intents": 2,
    "is_premium": false
}

GET /emoji_alias_list

Returns a map, mapping emoji to a list of its aliases.

https://botdesignerdiscord.com/public/api/emoji_alias_list

Response Example - 200

{
    "#️⃣": [
        ":hash:",
        ":keycap_hash:"
    ],
    "*️⃣": [
        ":keycap_asterisk:",
        ":asterisk:"
    ],
    "0️⃣": [
        ":keycap_0:",
        ":zero:"
    ],
    "1️⃣": [
        ":keycap_1:",
        ":one:"
    ], 
    ... 
}

Intents

0: None
2: Member Intent
256: Presence Intent

What is this?

Read more about intents in the our “Gateway Intents” guide.

Data Structures

Can be empty? means the field can be set to a default value.
Can be omitted? means the field might not be included in the response.

Function

Field name	Type	Description	Can be empty?	Can be omitted?
tag	String	Function name	False	False
shortDescription	String	Description for a function without parameters	True	False
longDescription	String	Description for a function with parameters	True	False
arguments	Array of Parameters	Parameters needed by a function	True	False
intents	Integer	Discord intents needed by bot to execute this function	False	False
premium	Bool	Function needs premium	False	False
deprecated	Bool	Function is deprecated	False	True
deprecatedFor	String	Name of the function that should be used instead	False	True

Parameters

Field name	Type	Description	Can be omitted?
name	String	Parameter name	False
description	String	Description for a function’s parameter	True
type	String Parameter Types	Parameter type. `\|` is used for a compound type	False
required	bool	Parameter is required	False
tupleTypes	Array of Parameters	Array of parameters which can be repeated, i.e `Channel ID;Message ID;Channel ID;Message ID;...`	True
empty	Bool	Parameter can be empty	True
ellipsis	Bool	Parameter accepts more data, i.e `Username 1;Username 2;Username 3;...`	True
enumData	Array of Strings	Possible options accepted as parameter, i.e `primary/secondary/or/etc`	True

Parameter Types

Multiple types can be merged together with | (OR).
Possible parameter types:

String
Integer
Float
Snowflake
Bool
Color
Permission
Duration
HowMany (>, 2, <, etc)
URL
Enum
Tuple

Bot Designer For Discord