> ## 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.

# Limits

> Defaults and maximums for Ravenna workflows: loop and Goto limits, wait timeouts, step retries and timeouts, HTTP Request timeouts, search result sizes, and webhook payload size.

Defaults and maximums that apply to workflow steps. Design around these when a workflow handles lists, waits a long time, or calls other systems.

## Limits

| Area | Limit |
| - | - |
| Loop | At most 50 items per loop; a lower Limit processes fewer |
| Goto | Upstream targets only; budget default 1, max 100; when spent, continues down On Limit Reached |
| Wait | Default 8h; supports Forever and relative durations |
| Wait for Approval | Default 3d; timeout continues down On Timeout |
| Wait for Message | Default 3d; timeout continues with Is Success false |
| Wait for Inactivity | Default 8h |
| Monitor Ticket | Default 8h; Forever is capped at one year; no match stops the path |
| AI Conversation Monitor | Default 24h |
| Step attempts | Up to 3 on temporary errors, about 3 seconds apart; permanent errors fail immediately |
| Step attempt time | 5 minutes |
| AI steps | 4 minutes per attempt |
| HTTP Request | Timeout default 10s, max 45s |
| Search Tickets | 1 to 50 results |
| Search Users | Explicit limit 1 to 10; empty returns up to 50 |
| Search Assets | Up to 50 results |
| Search Entitlements | Default 100, max 500 |
| Webhook Trigger body | 10 MB |
| Slack Send Group DM Message | 2 to 8 users |

## Design guidance

* **Lists over 50 items need batching.** Narrow the search filters, or split the work across several Cron runs, rather than relying on one Loop.
* **Long external work belongs outside the step.** A single step attempt stops after 5 minutes. For slow external jobs, start the job with HTTP Request, then Wait and check again with Goto.
* **Make steps safe to repeat.** A step can run up to 3 times on temporary errors, so prefer actions and API calls that don't create duplicates when repeated.


## Related topics

- [API overview](https://docs.ravenna.ai/api/overview.md)
- [Security](https://docs.ravenna.ai/guides/playbooks/security/overview.md)
- [AI trust & privacy](https://docs.ravenna.ai/documentation/automate/agents/trust-privacy.md)
- [Actions](https://docs.ravenna.ai/documentation/automate/workflows/actions.md)
- [Workflows](https://docs.ravenna.ai/documentation/automate/workflows/overview.md)


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