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

# Limits

> Every size, count, rate, and time limit you can hit in Managed Agents, with the error you get and where each is explained.

This page collects every limit you can run into, grouped by area. When a request goes over one, the error's `details` usually reports the limit and the measured value, so your code can react without parsing the message.

## Account and access

| Limit                         | Value                        | Details                                                            |
| ----------------------------- | ---------------------------- | ------------------------------------------------------------------ |
| API key name                  | 100 characters               | [API keys](/managed-agents/api-keys)                               |
| API key lifetime              | 365 days. Every key expires. | [API keys](/managed-agents/api-keys)                               |
| Live organizations per tenant | 100                          | [Organizations and roles](/managed-agents/organizations-and-roles) |
| Organization name             | 40 characters                | [Organizations and roles](/managed-agents/organizations-and-roles) |
| Tenant name                   | 100 characters               | [Organizations and roles](/managed-agents/organizations-and-roles) |

## Requests

| Limit                   | Value                                                                                                  | When exceeded                                  |
| ----------------------- | ------------------------------------------------------------------------------------------------------ | ---------------------------------------------- |
| Request rate per person | Not published. Shared across all your keys and console use.                                            | `429 rate_limit_exceeded` with `Retry-After`.  |
| Open event streams      | Not published.                                                                                         | `503 service_unavailable`.                     |
| `Idempotency-Key`       | 1 to 256 visible ASCII characters, one header value                                                    | `400 invalid_request`.                         |
| Idempotency memory      | About 24 hours for a completed request. An abandoned in-progress key can be reused after about 1 hour. | After that, the same key starts a new request. |
| Session list page token | Valid for 1 hour, with the same filters and `limit`                                                    | `400 invalid_request` on `page_token`.         |

See [API conventions](/managed-agents/api#rate-limits) for retry guidance.

## Agents

| Limit                          | Value                                                                   | Details                                          |
| ------------------------------ | ----------------------------------------------------------------------- | ------------------------------------------------ |
| Agent name                     | 256 characters                                                          | [Agent setup](/managed-agents/agents)            |
| Skills on one agent or session | 100, after groups are expanded and duplicates removed                   | [Skills](/managed-agents/skills)                 |
| `max_concurrent_sessions`      | 1 to 10,000, or unset for no cap. Extra root sessions wait as `queued`. | [Usage and cost](/managed-agents/usage-and-cost) |
| Tags on one agent              | 32                                                                      | [Agent setup](/managed-agents/agents)            |
| Tags per organization          | 200                                                                     | [Agent setup](/managed-agents/agents)            |
| Tag label                      | 32 characters                                                           | [Agent setup](/managed-agents/agents)            |
| Tag description                | 280 characters                                                          | [Agent setup](/managed-agents/agents)            |
| Tag ids in one list filter     | 32                                                                      | [Agent setup](/managed-agents/agents)            |

## Sessions and events

| Limit                                | Value                                                                                                                                                       | Details                                                    |
| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| Custom metadata on a session         | 32 pairs. Keys up to 64 characters of letters, digits, `_`, `.`, and `-`. Values 1 to 512 characters. Can't be changed after start.                         | [Sessions](/managed-agents/sessions)                       |
| Metadata filters in one list request | 32 `metadata` pairs and 32 `metadata_key` values                                                                                                            | [Session operations](/managed-agents/session-operations)   |
| Referenced sessions                  | 10 per request. A session keeps the 10 most recent.                                                                                                         | [Referenced sessions](/managed-agents/referenced-sessions) |
| Session list page                    | 100 by default, 1,000 at most                                                                                                                               | [Session operations](/managed-agents/session-operations)   |
| Event list page                      | 100 events by default. A page stops at about 8 MiB, so it can hold fewer.                                                                                   | [Events](/managed-agents/events)                           |
| One stream record                    | The stream's `Content-Type` states the largest record it sends. A larger event arrives as `event_record_too_large`; fetch it with `getSessionEventContent`. | [Events](/managed-agents/events)                           |
| Stream keep-alive                    | A ping every 15 seconds                                                                                                                                     | [Events](/managed-agents/events)                           |
| Live snapshot (gestalt)              | 5,000 sessions, over a 30-day window (400 days when filtered by `agent_id`)                                                                                 | [Events](/managed-agents/events)                           |
| Resource-sample page                 | 120 buckets by default, 720 at most                                                                                                                         | [Session operations](/managed-agents/session-operations)   |
| Sandbox provisioning                 | Fails with `sandbox_provision_timeout` if compute isn't ready within 5 minutes                                                                              | [Sessions](/managed-agents/sessions)                       |

## Outcomes

| Limit                     | Value                                                                 | Details                              |
| ------------------------- | --------------------------------------------------------------------- | ------------------------------------ |
| Criteria in one rubric    | 1 to 200                                                              | [Outcomes](/managed-agents/outcomes) |
| Open outcomes per session | 1. Define the next after the current one is graded.                   | [Outcomes](/managed-agents/outcomes) |
| `max_iterations`          | Omitted or `0` means no cap. Any positive number caps grading passes. | [Outcomes](/managed-agents/outcomes) |
| Criterion weight          | Always 1                                                              | [Outcomes](/managed-agents/outcomes) |

## Deliverables

| Limit                                  | Value                                                                | Details                                |
| -------------------------------------- | -------------------------------------------------------------------- | -------------------------------------- |
| Files kept per turn                    | 200                                                                  | [Artifacts](/managed-agents/artifacts) |
| Bytes kept per turn                    | 512 MiB                                                              | [Artifacts](/managed-agents/artifacts) |
| One deliverable file                   | 64 MiB                                                               | [Artifacts](/managed-agents/artifacts) |
| Files considered in the outputs folder | 10,000 per turn                                                      | [Artifacts](/managed-agents/artifacts) |
| Deliverable file name                  | 255 characters, no control characters                                | [Artifacts](/managed-agents/artifacts) |
| Image shown with `share_file`          | PNG, JPEG, or WebP; 5 MiB, 8,192 pixels on a side, and 40 megapixels | [Artifacts](/managed-agents/artifacts) |
| Images per session                     | 500 images and 100 MiB, across every tool that returns images        | [Artifacts](/managed-agents/artifacts) |

A file over the per-file size, or with a name that breaks the rules above, isn't kept, and the session records a warning. Files past a turn's file or byte cap wait for the next turn. Download kept files from the session's **Files** tab; see [Files](/managed-agents/files).

## Tools

| Limit              | Value                                    | Details                                    |
| ------------------ | ---------------------------------------- | ------------------------------------------ |
| MCP server request | 60-second timeout; responses up to 8 MiB | [MCP servers](/managed-agents/mcp-servers) |

## Integrations

| Limit                                       | Value                                                                       | Details                                                                                 |
| ------------------------------------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| Connections per app                         | 1 per organization                                                          | [Integrations](/managed-agents/integrations#connect-an-app)                             |
| Tools on one app's allow-list               | 1 to 200. Over the cap or empty, `400 invalid_request` on `resources`.      | [Integrations](/managed-agents/integrations#choose-which-tools-agents-may-use)          |
| Tool name                                   | 128 characters                                                              | [Integrations](/managed-agents/integrations#choose-which-tools-agents-may-use)          |
| Apps granted to one agent                   | 25 entries in `built_in_integrations`. Over the cap, `400 invalid_request`. | [Integrations](/managed-agents/integrations#grant-apps-to-an-agent)                     |
| Catalog `search`                            | 200 characters                                                              | [Integrations](/managed-agents/integrations#the-catalog)                                |
| Session access to an app                    | Expires within an hour, renewed while the session runs                      | [Integrations](/managed-agents/integrations#what-a-session-receives)                    |
| Skill slots a session with apps uses        | 1 of the session's 100                                                      | [Integrations](/managed-agents/integrations#what-a-session-receives)                    |
| GitHub repositories in one grant            | 500                                                                         | [GitHub access](/managed-agents/github)                                                 |
| Native integration connections on one agent | 25                                                                          | [Integrations](/managed-agents/integrations#grant-a-native-integration-to-an-agent)     |
| Install link (`state`)                      | Valid for 15 minutes, once                                                  | [Integrations](/managed-agents/integrations#connect-a-service)                          |
| Repository and pull request pages           | 100 per page                                                                | [Integrations](/managed-agents/integrations#list-github-repositories-and-pull-requests) |
| Slack channel list                          | 1,000 channels the Slack app is a member of                                 | [Automations](/managed-agents/automations#slack)                                        |

## Memory

| Limit                               | Value                                                  | Details                                                             |
| ----------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------- |
| One memory's content                | 100 KiB                                                | [Memory](/managed-agents/memory)                                    |
| One memory's summary                | 512 characters                                         | [Memory](/managed-agents/memory)                                    |
| Memories in one store               | 10,000                                                 | [Memory](/managed-agents/memory)                                    |
| Stores one session uses             | 8, including the agent's learned memory                | [Memory](/managed-agents/memory)                                    |
| Attachment instructions             | 4,096 characters                                       | [Memory](/managed-agents/memory)                                    |
| Version history                     | 30 days, plus the recent versions of every live memory | [Memory](/managed-agents/memory#review-restore-and-redact-versions) |
| Memory, activity, and history pages | 1 to 100, default 50                                   | [Memory](/managed-agents/memory)                                    |

## Files

| Limit                              | Value                                                         | Details                                                              |
| ---------------------------------- | ------------------------------------------------------------- | -------------------------------------------------------------------- |
| One upload                         | 64 MiB                                                        | [Files](/managed-agents/files)                                       |
| Live files per organization        | 10 GiB in total. Over it, `413 file_quota_exceeded`.          | [Files](/managed-agents/files)                                       |
| Upload expiry                      | 1 hour to 90 days, or none                                    | [Files](/managed-agents/files)                                       |
| Files attached in one request      | 500                                                           | [Files](/managed-agents/files)                                       |
| File list page                     | 200 by default, 1,000 at most; 100 ids in a `file_ids` lookup | [Files](/managed-agents/files)                                       |
| Documents named in one message     | 512 KiB each and 1 MiB per message                            | [Files](/managed-agents/files#show-a-file-to-the-agent-in-a-message) |
| Library files named in one message | 100 blocks and 32 MiB                                         | [Files](/managed-agents/files#show-a-file-to-the-agent-in-a-message) |
| Rubric file                        | 256 KiB of UTF-8 text                                         | [Outcomes](/managed-agents/outcomes)                                 |

## Automations

| Limit                    | Value                                                                    | Details                                                                   |
| ------------------------ | ------------------------------------------------------------------------ | ------------------------------------------------------------------------- |
| Triggers per automation  | 20                                                                       | [Automations](/managed-agents/automations)                                |
| Opening prompt           | 65,536 characters                                                        | [Automations](/managed-agents/automations)                                |
| Run defaults             | 50 vaults, 500 credentials, 500 files, 7 curated memory stores           | [Automations](/managed-agents/automations#set-run-defaults)               |
| Schedule catch-up window | 10 seconds to one year, default 15 minutes                               | [Automations](/managed-agents/automations#schedule)                       |
| Schedule jitter          | 0 to 540 seconds, default 10                                             | [Automations](/managed-agents/automations#schedule)                       |
| Trigger filters          | 100 Slack channels, 100 GitHub repositories, 20 webhook field conditions | [Automations](/managed-agents/automations#choose-triggers)                |
| Custom webhook body      | 1 MiB. Larger bodies get `413 payload_too_large`.                        | [Automations](/managed-agents/automations#send-a-custom-webhook-delivery) |

## Evaluations and analytics

| Limit                       | Value                | Details                                    |
| --------------------------- | -------------------- | ------------------------------------------ |
| Sessions per evaluation run | 100                  | [Evaluations](/managed-agents/evaluations) |
| Sessions judged at once     | 1 to 25, default 8   | [Evaluations](/managed-agents/evaluations) |
| Evaluation page token       | Valid for 1 hour     | [Evaluations](/managed-agents/evaluations) |
| Analytics breakdown rows    | 1 to 100, default 25 | [Analytics](/managed-agents/analytics)     |
| Stacked analytics series    | 8 groups             | [Analytics](/managed-agents/analytics)     |

## Skills

| Limit                    | Value                         | Details                          |
| ------------------------ | ----------------------------- | -------------------------------- |
| Skill name               | 64 characters                 | [Skills](/managed-agents/skills) |
| Skill description        | 1,024 characters              | [Skills](/managed-agents/skills) |
| Skill instructions body  | 64,000 characters             | [Skills](/managed-agents/skills) |
| Compressed bundle upload | 8 MiB                         | [Skills](/managed-agents/skills) |
| Unpacked bundle          | 32 MiB                        | [Skills](/managed-agents/skills) |
| One file in a bundle     | 4 MiB                         | [Skills](/managed-agents/skills) |
| Files in a bundle        | 500                           | [Skills](/managed-agents/skills) |
| Folder depth in a bundle | 3 levels below the skill root | [Skills](/managed-agents/skills) |
| Skill list page          | 100 by default, 500 at most   | [Skills](/managed-agents/skills) |
| Skill search term        | 2 to 256 characters           | [Skills](/managed-agents/skills) |

## Environments

| Limit                         | Value                                                                                                                                      | Details                                                                 |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------- |
| Setup script                  | 64 KiB                                                                                                                                     | [Environments](/managed-agents/environments)                            |
| Setup timeout                 | 10 to 3,600 seconds. `0` or unset uses 600.                                                                                                | [Environment reference](/managed-agents/environments-reference)         |
| CPU                           | At least 250 millicores. The maximum depends on the compute available, and the error names it.                                             | [Environment reference](/managed-agents/environments-reference)         |
| Memory                        | At least 1,024 MiB. The maximum depends on the compute available.                                                                          | [Environment reference](/managed-agents/environments-reference)         |
| GPU sandbox                   | One GPU, with 8,000 millicores and 32,768 MiB set for you                                                                                  | [Environment reference](/managed-agents/environments-reference#compute) |
| Sandbox lifetime              | 10 to 86,400 seconds when set                                                                                                              | [Environment reference](/managed-agents/environments-reference)         |
| Workspace disk in the console | 1 to 1,000 GiB. Unset uses the default.                                                                                                    | [Environment reference](/managed-agents/environments-reference)         |
| Idle stop                     | 120 to 2,592,000 seconds (30 days) when set; `0` uses the default of 30 minutes. With computer use, `0` or at least 600.                   | [Environment reference](/managed-agents/environments-reference)         |
| Stopped sandbox retention     | 3,600 to 2,592,000 seconds when set                                                                                                        | [Environment reference](/managed-agents/environments-reference)         |
| Network policy rules          | 200                                                                                                                                        | [Environment reference](/managed-agents/environments-reference)         |
| Setup runs in flight          | 1 per environment, and 4 per organization by default. Over the organization cap, `429 setup_run_limit` reports the cap in `details.limit`. | [Environments](/managed-agents/environments)                            |
| Setup-run list page           | 50                                                                                                                                         | [Environments](/managed-agents/environments)                            |
| Setup-run log kept            | 4 MiB per run, plus a 2 KiB `stderr_tail`                                                                                                  | [Environments](/managed-agents/environments)                            |
| Setup-run log page            | 500 lines by default, 2,000 at most                                                                                                        | [Environments](/managed-agents/environments)                            |
| Setup-run wait                | `wait_seconds` accepts 0 to 60, but waits at most 5 seconds                                                                                | [Environments](/managed-agents/environments)                            |
| Setup-run stderr tail         | 2 KiB                                                                                                                                      | [Environments](/managed-agents/environments)                            |

## Multi-agent

| Limit                    | Value                      | Details                                    |
| ------------------------ | -------------------------- | ------------------------------------------ |
| Roster entries           | 20, with at most 1 advisor | [Multi-agent](/managed-agents/multi-agent) |
| `max_depth`              | 1 by default, 3 at most    | [Multi-agent](/managed-agents/multi-agent) |
| `max_concurrent_threads` | 8 by default, 25 at most   | [Multi-agent](/managed-agents/multi-agent) |
| `max_threads`            | 25 by default, 100 at most | [Multi-agent](/managed-agents/multi-agent) |

Child sessions don't count toward an agent's `max_concurrent_sessions`.

## Next steps

<CardGroup cols={2}>
  <Card title="Errors" href="/managed-agents/errors">
    Every error code, its cause, and whether to retry.
  </Card>

  <Card title="API conventions" href="/managed-agents/api">
    Retries, idempotency, and paging.
  </Card>

  <Card title="Troubleshooting" href="/managed-agents/troubleshooting">
    Match a symptom to its cause and fix.
  </Card>

  <Card title="Event types and states" href="/managed-agents/reference">
    Look up every status, event type, and result value.
  </Card>
</CardGroup>
