Reference
Limits & quotas
Every size, time and count limit that applies to Chataway apps, in one place.
| Limit | Value | Notes |
|---|
| Time per call | 120 s | Return a job id and add a status tool for longer work. |
| Response size | 50 MB | Text + files in one CallToolResult; larger responses fail. |
| One file sent to your server | ≤ maxBytes, at most 20 MiB | After prepare. Arrives base64-encoded (≈ 27 MB of JSON). |
| Calls per app | 60 per minute, across projects | A limited call fails with an error the agent sees. |
| Hand-off consent | Once per (project, from, to) with Always | Otherwise every hand-off. |
| Limit | Value |
|---|
| Media length | 10 minutes (times 0–600 s) |
| Dimensions | 8192 px per side |
Offsets (x, y) | 0–16384 |
quality | 1–100 |
targetKb | 10–50,000 |
| Concurrent jobs | 2 per app; more wait in the queue |
#AI (app API 4)
| Limit | Value | Notes |
|---|
| AI calls per app per day | 300 by default | Every model request counts: panel calls and streams, MCP sampling, each agent-run turn, server code's ctx.models, and each JSON retry. The user can change it per app (0 = AI off). Over the limit → budget (HTTP 429). Chataway's own apps have no limit unless the user sets one. |
| Day | The user's local day | |
| Calls at once | 2 per app | The rest wait. |
| Model call time | 120 s | |
| Prompt size | 200,000 characters, ≤ 100 messages | |
| Images per call | 8, ≤ 5 MB each | png, jpeg, webp, gif |
maxTokens | default 1000, 16–16,000 | |
#Folders and files (app API 4)
| Limit | Value |
|---|
File size (fs.read, fs.write) | 25 MB |
| File operations | 600 per minute per app |
fs.list | 2000 entries (truncated: true beyond); version for files ≤ 1 MB, at most 200 per listing; recursive 20 levels deep |
| Backups | 20 per file, 200 MB per app (oldest removed first) |
| Change events | debounced 150 ms |
A file: root ("Open with") | 24 hours, until Chataway restarts, and until the app is switched off in the project |
| Click-only calls | One of each kind per click in the panel, at most one every 5 seconds |
#Agent runs (app API 4)
| Limit | Value |
|---|
| Tool calls | 30 by default (maxSteps), at most 60 |
| Time | 10 minutes |
| Running runs | 1 per app per project (busy) |
task | 1–4000 characters |
roots | 1–10 |
#Chats (chat.*)
| Limit | Value |
|---|
| Message text | 100,000 characters |
| Attachments | 20 per message |
chat.create title | 120 characters |
A queued chat.compose | waits 2 minutes for the chat's composer |
#Manifest
| Field | Limit |
|---|
id | ≤ 64 characters |
name | ≤ 40 characters |
description | ≤ 400 characters |
permissions[] | ≤ 200 characters each |
publisher | ≤ 40 characters |
categories | ≤ 3 |
remote.domains | ≤ 20 |
Tool id | ≤ 48 characters, [a-z][a-z0-9_]* |
Tool name | ≤ 60 characters |
Tool description | ≤ 1024 characters |
confirm.title | ≤ 120 characters |
Panel id, title | ≤ 40 characters |
Account id, label | ≤ 40 characters |
Account clientId | ≤ 200 characters |
| Scope | ≤ 100 characters each |
requires.hostApi | integer ≥ 3 |
contributes.instructions | 1–2000 characters |
contributes.prompts | ≤ 20; title ≤ 60, description ≤ 200, text ≤ 4000, ≤ 8 vars (label ≤ 40) |
contributes.folders | ≤ 5; label ≤ 40, 1–20 extensions, reason 10–200 |
contributes.fileHandlers | ≤ 10; label ≤ 40, 1–20 extensions |
storage.zones | ≤ 20 |
#Bundle and branding
| Limit | Value |
|---|
| Bundle (zip) | 25 MiB |
| Paths | ≤ 300 characters, relative, no .. |
| Icon | ≤ 1 MB, square, ≥ 256 px (512×512 recommended) |
| Mark | ≤ 1 MB, SVG |
| Screenshots | ≤ 8, ≤ 3 MB each |
| README shown in the store | first 200,000 characters |
| CHANGELOG shown with updates | first 100,000 characters |
#Accounts
| Limit | Value |
|---|
| OAuth code kept by the relay | 5 minutes, read once |
state | 32–256 URL-safe characters (generated by Chataway) |
#Store
| Limit | Value |
|---|
| Upload size | 25 MiB |
| Versions | Each upload needs a version greater than every earlier upload of the app |
| Device sign-in code | 10 minutes |
| Revocation check on the Mac | Hourly and at startup |
Limits can change; the changelog records it when they do.