# Actions

{% hint style="warning" %}
**Our documentation page is undergoing a rework. Some pages are incomplete.**

We are working overtime to resolve this issue, please visit our [Support Server](https://discord.gg/YHVry73av9) if you need any additional help, or would like to report any bugs or suggestions.
{% endhint %}

Action blocks let you define what your bot should do, such as sending a message or performing a task. They can be used in any builder, whether you’re setting up a new event or creating a command.

The following subpages break down each category, such as message blocks and channel blocks. Each section provides detailed explanations of every block along with step-by-step setup instructions. If you ever get stuck or need extra guidance, our [Discord Server](https://discord.gg/botwiz) is available for one-on-one support.

{% hint style="info" %}
Some pages may explain multiple action blocks. \
E.g. [Delete & Pin a Message](/docs/blocks/actions/message-or-embed-actions/delete-and-pin-a-message.md) will explain the 'Delete Message' and 'Pin Message' blocks.
{% endhint %}

## List of our Action Blocks

For those new to BotWiz, below you can find a list of our available action blocks. Each can be performed by your bot whenever a command or event has been executed! With each block listed, a brief explanation will be provided along with a link to its subpage.

### Message or Embed

<table><thead><tr><th width="166">Action Block</th><th width="354">Description</th><th>Subpage Link</th></tr></thead><tbody><tr><td>Modal</td><td>Open a form for users to answer questions.</td><td><a data-mention href="/pages/gEHHUm9Qi1fTJvwXKUKY">/pages/gEHHUm9Qi1fTJvwXKUKY</a></td></tr><tr><td>Start Poll</td><td>Start a custom Discord poll.</td><td><a data-mention href="/pages/jgMaFwGgLEAty9sw1TkV#start-poll">/pages/jgMaFwGgLEAty9sw1TkV#start-poll</a></td></tr><tr><td>Stop Poll</td><td>End an ongoing Discord poll.</td><td><a data-mention href="/pages/jgMaFwGgLEAty9sw1TkV#end-poll">/pages/jgMaFwGgLEAty9sw1TkV#end-poll</a></td></tr><tr><td>Send Message</td><td>Get your bot to send a custom message.</td><td><a data-mention href="/pages/6duzUXUvMCsi2qxNqcQY">/pages/6duzUXUvMCsi2qxNqcQY</a></td></tr><tr><td>Add Reaction</td><td>Add a reaction to a message.</td><td></td></tr><tr><td>Remove Reaction</td><td>Remove a reaction from a message.</td><td></td></tr><tr><td>Forward Message</td><td>Forward a message.</td><td></td></tr><tr><td>Publish Message</td><td>Publish a message.</td><td></td></tr><tr><td>Delete Message</td><td>Delete a message.</td><td><a data-mention href="/pages/3NqjrCvO4WyK0cL3NLxx#delete-a-message">/pages/3NqjrCvO4WyK0cL3NLxx#delete-a-message</a></td></tr><tr><td>Copy Message</td><td>Copy a message.</td><td></td></tr><tr><td>Edit Message</td><td>Edit a message.</td><td></td></tr><tr><td>Pin Message</td><td>Pin a message.</td><td><a data-mention href="/pages/3NqjrCvO4WyK0cL3NLxx#pin-a-message">/pages/3NqjrCvO4WyK0cL3NLxx#pin-a-message</a></td></tr></tbody></table>

### Voice Actions

| Action Block            | Description                                 | Subpage Link |
| ----------------------- | ------------------------------------------- | ------------ |
| Join Channel            | Join a channel.                             |              |
| Leave Channel           | Leave a channel.                            |              |
| Mute                    | Mute a member.                              |              |
| Unmute                  | Unmute a member.                            |              |
| Deafen                  | Deafen a member.                            |              |
| Undeafen                | Undeafen a member.                          |              |
| Disconnect              | Disconnect a member from a channel.         |              |
| Request to Speak        | Request to speak in a stage channel.        |              |
| Remove request to Speak | Remove request to speak in a stage channel. |              |
| Suppress                | Suppress a user or channel.                 |              |
| Remove Suppress         | Remove suppress from a user or channel.     |              |

### Role Actions

<table><thead><tr><th width="166">Action Block</th><th width="300">Description</th><th>Subpage Link</th></tr></thead><tbody><tr><td>Add Roles to Everyone</td><td>Assign a role to every user in the server.</td><td><a data-mention href="/pages/i8UAVjYRuMYxmNMSTfGu">/pages/i8UAVjYRuMYxmNMSTfGu</a></td></tr><tr><td>Add Role</td><td>Assign a role to a user.</td><td><a data-mention href="/pages/sfV5JwGqu4wVrRFOrH7R">/pages/sfV5JwGqu4wVrRFOrH7R</a></td></tr><tr><td>Create Role</td><td>Create a new guild role.</td><td><a data-mention href="/pages/sfV5JwGqu4wVrRFOrH7R">/pages/sfV5JwGqu4wVrRFOrH7R</a></td></tr><tr><td>Delete Role</td><td>Delete a guild role.</td><td><a data-mention href="/pages/ddaymeMLyPoe9A7Ywp05">/pages/ddaymeMLyPoe9A7Ywp05</a></td></tr><tr><td>Edit Role</td><td>Edit a guild role.</td><td><a data-mention href="/pages/v6W8mdaUAUv3XjICQHHE">/pages/v6W8mdaUAUv3XjICQHHE</a></td></tr><tr><td>Remove Roles</td><td>Remove a role from a user.</td><td><a data-mention href="/pages/ddaymeMLyPoe9A7Ywp05">/pages/ddaymeMLyPoe9A7Ywp05</a></td></tr><tr><td>Remove Roles from Everyone</td><td>Remove a role from everyone in the server.</td><td><a data-mention href="/pages/i8UAVjYRuMYxmNMSTfGu">/pages/i8UAVjYRuMYxmNMSTfGu</a></td></tr></tbody></table>

### Channel Actions

<table><thead><tr><th width="166">Action Block</th><th width="380">Description</th><th>Subpage Link</th></tr></thead><tbody><tr><td>Create Channel</td><td>Create a guild channel.</td><td><a data-mention href="/pages/JgGGvrNTD4xGqCaILA7P">/pages/JgGGvrNTD4xGqCaILA7P</a></td></tr><tr><td>Delete Channel</td><td>Delete a guild channel.</td><td><a data-mention href="/pages/SwEvQYCFB2kGW5tXELbl">/pages/SwEvQYCFB2kGW5tXELbl</a></td></tr><tr><td>Edit Channel</td><td>Edit a guild channel.</td><td><a data-mention href="/pages/cNmpBii0TGWgQMGRDm3U">/pages/cNmpBii0TGWgQMGRDm3U</a></td></tr><tr><td> Purge</td><td>Purge messages in a guild channel.</td><td><a data-mention href="/pages/7HKAdeOBndH89e3l7Gwh">/pages/7HKAdeOBndH89e3l7Gwh</a></td></tr></tbody></table>

### Member Actions

<table><thead><tr><th width="191">Action Block</th><th width="354">Description</th><th>Subpage Link</th></tr></thead><tbody><tr><td>Manage Nickname</td><td>Update a member's nickname in a guild.</td><td><a data-mention href="/pages/GK6QOVRlayXXqXqKId2w">/pages/GK6QOVRlayXXqXqKId2w</a></td></tr><tr><td>Timeout Member</td><td>Timeout / mute a guild member.</td><td><a data-mention href="/pages/UbDPn0IyYP9q0VN5eHzA">/pages/UbDPn0IyYP9q0VN5eHzA</a></td></tr><tr><td>Kick Member</td><td>Kick a member from a guild.</td><td><a data-mention href="/pages/ejkW8SdPUBhnTuIhlyXc">/pages/ejkW8SdPUBhnTuIhlyXc</a></td></tr><tr><td>Unban Member</td><td>Unban a member from a guild.</td><td><a data-mention href="/pages/MsetEm3W4qw3CVF2HdTk">/pages/MsetEm3W4qw3CVF2HdTk</a></td></tr><tr><td>Ban Member</td><td>Ban a member from a guild.</td><td><a data-mention href="/pages/EpghTxiUOQzxTmV6S87m">/pages/EpghTxiUOQzxTmV6S87m</a></td></tr></tbody></table>

### Variable Actions

<table><thead><tr><th width="186">Action Block</th><th width="354">Description</th><th>Subpage Link</th></tr></thead><tbody><tr><td>Calculate Variable</td><td>Run an equation on a variable.</td><td><a data-mention href="/pages/qYBhHSV2CIhY1n2hCe8e">/pages/qYBhHSV2CIhY1n2hCe8e</a></td></tr><tr><td>Delete Variable</td><td>Remove the values from a variable.</td><td><a data-mention href="/pages/5a9fb5UfAzY67H01pPZn">/pages/5a9fb5UfAzY67H01pPZn</a></td></tr><tr><td>Set Variable</td><td>Set a variable to a specific value.</td><td><a data-mention href="/pages/cXfyGXZWUNaF6PVPxAyf">/pages/cXfyGXZWUNaF6PVPxAyf</a></td></tr></tbody></table>

### Action Blocks

<table><thead><tr><th width="166">Action Block</th><th width="374">Description</th><th>Subpage Link</th></tr></thead><tbody><tr><td>API</td><td>Use external API in your build.</td><td><a data-mention href="/pages/vzNVUhnSReSnEgzyxrZs">/pages/vzNVUhnSReSnEgzyxrZs</a></td></tr><tr><td>Break Loop</td><td>End an ongoing loop early.</td><td><a data-mention href="/pages/5PVbBIZFi729oQDqhOZT#break-a-loop">/pages/5PVbBIZFi729oQDqhOZT#break-a-loop</a></td></tr><tr><td>Loop</td><td>Start a loop.</td><td><a data-mention href="/pages/5PVbBIZFi729oQDqhOZT#start-a-loop">/pages/5PVbBIZFi729oQDqhOZT#start-a-loop</a></td></tr><tr><td>Wait</td><td>Wait before the next block starts.</td><td><a data-mention href="/pages/095fi9XpSVJOgONCmA5Q#wait">/pages/095fi9XpSVJOgONCmA5Q#wait</a></td></tr><tr><td>Logging</td><td>Create custom logs for your bot logs.</td><td><a data-mention href="/pages/095fi9XpSVJOgONCmA5Q">/pages/095fi9XpSVJOgONCmA5Q</a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.botwiz.dev/docs/blocks/actions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.