> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ravenna.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Actions

> Reference for every built-in Ravenna workflow action: ticket, approval, wait, control flow, AI, messaging, access, asset, and HTTP actions, plus integration and Foundry actions.

Actions do the work in a workflow, using data from the trigger and from earlier steps. Most actions also have **Optional Filters**, which skip the action when they don't match.

## Action reference

| Action | Picker group | What it does |
| - | - | - |
| Create ticket | Ticket | Creates a fully configured ticket in any reachable channel, including other workspaces; can copy another ticket's form values |
| Update Ticket | Ticket | Changes ticket properties, requester, parent, custom fields |
| Publish Ticket | Ticket | Makes a newly created ticket visible and sends its notifications |
| Set Status / Set Priority / Set Type | Ticket | Changes one property. Type is Service, Incident, Problem, Change, or Access |
| Add Assignee | Ticket | Assigns one person: a named User, Round Robin over a list, or Random |
| Add Followers / Add Tags | Ticket | Adds followers or tags |
| Move Ticket / Share Ticket | Ticket | Moves to another channel or workspace, or shares into another workspace's channel |
| Send Message | Ticket | Public message, private note, or DM to one person |
| Link Ticket | Ticket | Attaches an external URL to a ticket |
| Apply Task Template / Complete Tasks | Ticket | Attaches a checklist, or completes matching tasks |
| Search Tickets | Ticket | Ticket IDs matching a filter (filter required, up to 50) |
| Search Users | Ticket | User IDs matching a filter (limit 1 to 10, or up to 50 when left empty) |
| Start Lifecycle | Ticket | Starts a lifecycle from a published template |
| Add Approval Round | Ticket | Adds an approval round with approvers, policy (any, all, majority), and strategy (All, Round Robin, Auto Approve) |
| Apply Approval Template | Ticket | Replaces the ticket's rounds with an approval template's rounds |
| Add Approvers | Ticket | Older approver action (All or Round Robin); prefer Add Approval Round |
| Wait / Wait Until | Wait | Pause for a duration (default 8h) or until a date, time, and timezone with an optional offset |
| Wait for Approval | Wait | Pause for a decision (default 3d); branches On Approved, On Declined, On Timeout |
| Wait for Message | Wait | Pause for a message from chosen authors (default 3d); Is Success reports whether one arrived |
| Wait for Inactivity | Wait | Pause until the ticket is quiet for a duration (default 8h) |
| Monitor Ticket | Ticket | Re-check conditions on every ticket update until they match (default 8h); the path stops if they never do |
| AI Conversation Monitor | Slack | Continue once the agent's Slack thread is quiet (default 24h); stops if feedback arrives |
| Conditional / If / Else | Control | Check conditions; Conditional never blocks, If / Else gates True and False paths |
| Goto | Control | Jump to an upstream step, up to its budget (default 1, max 100), then continue down On Limit Reached |
| Loop | Control | Run the loop body per item, at most 50 items |
| Summarize / AI Decision Maker / Custom Prompt | AI | Summary, True/False judgment, or free-form reasoning with structured outputs |
| Send Email | Tool | Email with branded sender, attachments, and follower auto-add |
| Send Form | Message | Sends a form over Slack or email, with pre-filled and locked fields; does not wait for submission |
| Send CSAT | Message | Sends a satisfaction survey |
| Search Entitlements / Revoke Entitlement | Access | Find entitlements and their holders (default 100, max 500), or revoke them |
| Create / Update / Archive / Search / Assign Asset | Asset | Manage assets; Search Assets returns up to 50 |
| HTTP Request | Tool | Calls an API with vault-backed auth and optional HMAC signing; timeout default 10s, max 45s |

## Patterns

* **Approval flow:** Add Approval Round (or Apply Approval Template), then Wait for Approval, then act on On Approved, On Declined, and On Timeout. Chain several Add Approval Round steps for sequential approvals. See [Approvals in workflows](https://docs.ravenna.ai/documentation/automate/workflows/approvals.md).
* **Bulk work:** Search Tickets, Search Users, Search Assets, or Search Entitlements, then Loop over the IDs. Pair with Cron for scheduled sweeps.
* **Access cleanup:** Search Entitlements into Revoke Entitlement, passing the entitlement IDs directly.
* **Bulk asset reassignment:** Search Assets into Assign Asset with Set assignees.
* **External calls:** prefer a native integration action over HTTP Request; they handle auth, errors, and output parsing. Use HTTP Request when no native or Foundry action exists.
* **Recoverable API failures:** turn off Fail on error on HTTP Request, then branch on Is Success.
* **Polling with retries:** Wait, then a check, then Goto back to the wait with a budget. Handle the On Limit Reached path.
* **Cross-team handoff:** Create ticket in the other workspace's channel with the Form set to the source ticket's form, so the receiving workflow can read the original answers.

## Gotchas

* **Add Assignee assigns exactly one person.** There is no "assign everyone" strategy. Use Add Followers to involve several people.
* **Round Robin rotates per step.** Each Add Assignee step has its own rotation, even when two steps share a list.
* **Auto Approve falls back to All when a round is already in progress.** It only auto-approves when the ticket has no active approval round; otherwise it adds every listed user.
* **Apply Approval Template replaces existing rounds.** Add Approval Round adds a round instead.
* **On Declined is explicit declines only.** A timeout goes down On Timeout.
* **Wait for Message ignores automated messages.** Workflow-generated and AI-generated messages never resume it.
* **Monitor Ticket stops the path on timeout.** Nothing after it runs if its conditions never match.
* **Goto only jumps upstream** and stops jumping when its budget is spent. It cannot skip ahead.
* **Loop processes at most 50 items.** Items past the limit are not processed.
* **Search Users limit.** An explicit limit must be 1 to 10; leaving it empty returns up to 50.
* **Send Form does not wait.** The step completes when the request is sent. Use a trigger such as Form Submitted on another workflow, or Monitor Ticket, to react to the submission.
* **Asset actions do not fire asset triggers.**
* **Update Ticket has no workspace field.** For a cross-workspace create, set every value on Create ticket.


## Related topics

- [Emoji actions](https://docs.ravenna.ai/integrations/slack/emoji-actions.md)
- [Choose triggers and actions](https://docs.ravenna.ai/documentation/automate/workflows/triggers-actions.md)
- [List apps with actions](https://docs.ravenna.ai/api/workflow/list-apps-with-actions.md)
- [Activate code action](https://docs.ravenna.ai/api/codeaction/activate-code-action.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.