Chataway Developers
Reference

Limits & quotas

Every size, time and count limit that applies to Chataway apps, in one place.

#Tool calls

LimitValueNotes
Time per call120 sReturn a job id and add a status tool for longer work.
Response size50 MBText + files in one CallToolResult; larger responses fail.
One file sent to your server≤ maxBytes, at most 20 MiBAfter prepare. Arrives base64-encoded (≈ 27 MB of JSON).
Calls per app60 per minute, across projectsA limited call fails with an error the agent sees.
Hand-off consentOnce per (project, from, to) with AlwaysOtherwise every hand-off.

#Host media

LimitValue
Media length10 minutes (times 0–600 s)
Dimensions8192 px per side
Offsets (x, y)0–16384
quality1–100
targetKb10–50,000
Concurrent jobs2 per app; more wait in the queue

#AI (app API 4)

LimitValueNotes
AI calls per app per day300 by defaultEvery 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.
DayThe user's local day
Calls at once2 per appThe rest wait.
Model call time120 s
Prompt size200,000 characters, ≤ 100 messages
Images per call8, ≤ 5 MB eachpng, jpeg, webp, gif
maxTokensdefault 1000, 16–16,000

#Folders and files (app API 4)

LimitValue
File size (fs.read, fs.write)25 MB
File operations600 per minute per app
fs.list2000 entries (truncated: true beyond); version for files ≤ 1 MB, at most 200 per listing; recursive 20 levels deep
Backups20 per file, 200 MB per app (oldest removed first)
Change eventsdebounced 150 ms
A file: root ("Open with")24 hours, until Chataway restarts, and until the app is switched off in the project
Click-only callsOne of each kind per click in the panel, at most one every 5 seconds

#Agent runs (app API 4)

LimitValue
Tool calls30 by default (maxSteps), at most 60
Time10 minutes
Running runs1 per app per project (busy)
task1–4000 characters
roots1–10

#Chats (chat.*)

LimitValue
Message text100,000 characters
Attachments20 per message
chat.create title120 characters
A queued chat.composewaits 2 minutes for the chat's composer

#Manifest

FieldLimit
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.hostApiinteger ≥ 3
contributes.instructions1–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

LimitValue
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 storefirst 200,000 characters
CHANGELOG shown with updatesfirst 100,000 characters

#Accounts

LimitValue
OAuth code kept by the relay5 minutes, read once
state32–256 URL-safe characters (generated by Chataway)

#Store

LimitValue
Upload size25 MiB
VersionsEach upload needs a version greater than every earlier upload of the app
Device sign-in code10 minutes
Revocation check on the MacHourly and at startup

Limits can change; the changelog records it when they do.