Buildcord

A bot in outline: its settings, every flow, embed, component set, modal, variable and collection by id and name, the names of its secrets, what's live, and everything the deploy check would object to.

get_bot

Read one embed, component set, modal, picture, script, variable or collection in full.

read_item

Read one flow in full: its trigger, every step with its settings and outputs, the wires between them, the {tokens} its steps can use, and anything wrong with it.

read_flow

How a bot's flows work, and every step a flow can be built from with its settings and outputs. Read it before building. Pass sections to read only some: message, member, server, voice, logic, data, integration, flow, events.

read_step_catalogue

Create a collection (a table of rows the data steps read and write), or change one when `id` is given.

save_collection

Create a modal (a form with up to five inputs: text, a menu of choices, or a file upload), or change one when `id` is given. Each answer is read afterwards as {modal.label_in_snake_case}: for a menu, the labels picked joined with ", "; for an upload, each file's address, one per line, which a message's files or an embed's thumbnail or image can use.

save_modal

Create a picture design, or change one when `id` is given: an image the bot draws as it runs, such as poll results, a profile card or a leaderboard. Layers are drawn in order, the first at the bottom, at pixel positions from the top left. Text settings take {tokens}. A list layer repeats its own layers once per item of a list or a collection's rows. A data.picture step fills it in as {temp.NAME}, which goes in a message's files or an embed's image.

save_picture

Create a script, or change one when `id` is given: shared JavaScript that integration.code steps, and other scripts, load with require("name"). It sets module.exports, or returns what it shares, such as `return { score, rank };`. It runs once per step that loads it, with no ctx: give its functions what they need. Keep helpers used by several code steps here instead of copying them or storing code in a variable.

save_script

Create a stored variable, or change one when `id` is given. Steps read it as {var.name}.

save_variable

Create an embed, or change one when `id` is given. Only the fields you pass change. Text may hold {tokens}.

save_embed

Create a set of buttons and select menus that message steps can attach, or change one when `id` is given. Returns the saved set with the id of every button and choice: a message.buttons step has an output `button:<id>` per button without an action, and a message.select step an output `choice:<id>` per choice.

save_components

Show the person a bot's flows, or draw one flow as a diagram, in an interactive card with a link to open it in the builder. Use it after building something, or when they ask to see it.

show_bot

The Buildcord account this connection is signed in as. Its id never changes.

whoami