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

# Limits

> Sizes, counts, and timeouts the API enforces.

A value outside its limit is `400 invalid_request`, with `details.field` naming it, or `details.errors` inside a template document. The limits marked **413** are the exceptions: going over them is `413 payload_too_large`, with `details.limit` and `details.max`. A file or a directory listing over its limit is a `413` without `details`, and the trigger webhook's `413` carries `details.reason` and `details.deliveryId` instead; see [the webhook](https://docs.paddock.build/api-reference/webhook.md).

## Templates and agents

| Limit | Value |
| - | - |
| One template document, as sent | 256 KiB (**413**) |
| A template name | `[a-z0-9-]`, 1 to 64 characters |
| A model name | 128 bytes |
| A system prompt: the template's, the agent's, or a session's composed one | 64 KiB (**413**) |
| An agent's whole effective configuration | 1 MiB (**413**) |
| An environment variable | Name up to 128 bytes; value up to 16 KiB |
| An MCP server or marketplace name | Up to 128 characters |

## Sessions and messages

| Limit | Value |
| - | - |
| One message | 100 KB of text (**413**) |
| A session's working directory | 1,024 bytes |
| Metadata and labels | 50 keys; keys up to 40 bytes, values up to 500 bytes |
| A session token's lifetime | 60 to 86,400 seconds |
| A list page | `limit` default 50, at most 200 |

## Files and memory

| Limit | Value |
| - | - |
| One read or write | 100 MB (**413**) |
| One directory listing | 10,000 entries (**413**) |
| Waking a sleeping agent for a file or memory operation | 30 seconds, then `503 unavailable` |

## Turns

| Limit | Value |
| - | - |
| The watchdog | A turn fails after 10 minutes without progress, or 60 minutes while a tool call is open |
| Retries of a failed turn | 2, after 10 and 60 seconds |
| Idle time before an agent sleeps | 10 minutes with no running, waiting, or retrying turn and no background work |

## Model providers

| Limit | Value |
| - | - |
| A provider name | `[a-z0-9-]`, 1 to 32 characters |
| Models per provider | 100 |
| An API key | 8 to 1,024 printable characters |
| A base URL | 512 bytes |
| Key verification | 10 seconds |

## Triggers

| Limit | Value |
| - | - |
| Rules per trigger | 50 |
| A webhook request body | 1 MiB (**413**), recorded as a rejected delivery |
| A trigger management request | 2 MiB (**413**) |
| A filter or dedupe expression | 4 KiB; every evaluation is bounded in cost and stops after 100 ms |
| A message template | 64 KiB; the rendered message 1 byte to 100 KB, or the rule's outcome fails with `template_error` |
| A session key template | 1 KiB; the rendered key 1 to 500 bytes, or the rule's outcome fails with `template_error` |
| Delivery attempts | 5, at 30 s, 2 min, 8 min, and 32 min apart |
| Delivery retention | Until the trigger is deleted |


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