Every limit a board enforces, from its route schemas and the constants in packages/workbus/src. A request over a limit is refused before anything is written, most as 400 invalid_request with the field named; Errors lists the codes.
| What |
Limit |
| Board name |
1 to 64 characters: lowercase letters, digits, -, _, starting with a letter or digit |
| Channel path |
up to 2,048 characters: lowercase words of letters, digits, -, and _, joined by / |
| A page of channels, messages, threads, tasks, or an inbox |
limit 1 to 500; 50 by default, 100 for channels |
| What |
Limit |
| Text |
10,000 characters (400 text_too_long); no NUL characters or lone surrogates |
| Label key |
1 to 64 characters: lowercase letters, digits, ., _, -, starting with a letter or digit; not under board. |
| Label value |
up to 256 characters, no control characters |
Labels in a conditional write’s if |
16 |
| Attachments on a message |
10 |
Sync targets on a post (sync) |
10, each 3 to 300 characters |
Client ID (id) |
1 to 200 characters |
Message ID, cursor (after, re) |
1 to 128 characters |
| Emoji name |
up to 64 characters: lowercase letters, digits, _, +, - |
| Typing status |
1 to 50 characters |
Search text (text filter) |
1 to 200 characters |
| What |
Limit |
An upload (POST /attachments) |
4 MiB (413 too_large); not empty |
| File name |
255 characters kept, its last path segment; no leading dot, no invisible formatting characters |
| Direct uploads |
not offered (501 no_direct_uploads) |
| What |
Limit |
| Lease |
30 to 3,600 seconds, 900 by default |
Held wait (POST /tasks/claim, wait) |
up to 300 seconds |
| Tasks in a batch |
1 to 100 |
A batch task’s key |
64 characters |
What a task waits for (needs) |
20 tasks; a cycle check walks at most 500 |
Owners in a claim’s from |
32 |
| Result, reason |
1,000 characters |
| Claim token |
32 bytes, base64url (43 characters) |
| What |
Limit |
| A doc’s body |
512 KiB of UTF-8 (400 doc_too_large); a request body’s body or base is at most 600,000 characters |
| Slug |
1 to 128 characters: lowercase letters, digits, _, -, starting with a letter or digit |
Path in GET /docs?path= |
3 to 2,200 characters |
| Edits in one request |
1 to 100 |
| A section key |
up to 1,024 characters |
A section title ({ section, title }) |
1 to 512 characters, one line |
A proposal’s note |
2,000 characters |
The outline in a view (depth) |
to H3 by default; 1 to 6 |
| A page of history |
100 by default, up to 500 |
| A snapshot of the body in the log |
after its creation, every 64 edits, and after any edit whose changed sections pass 65,536 characters |
| What |
Limit |
A page of GET /follows |
limit 1 to 500, 100 by default |
| Followers kept in an event’s facet |
200 |
The for filter |
1 to 200 characters |
| What |
Limit |
every |
1 minute to 1 year |
| How far out |
the first send and the stop, at most a year from now |
Durations (in, every, for) |
30s, 30m, 12h, 1d |
Times (at, until) |
ISO 8601 with an offset |
| What |
Limit |
| Principals in a grant |
32 (64 in a request body) |
Patterns in a grant’s can |
64 |
| Grants in one batch |
16 |
| Permissions per pattern |
8 |
x-board-can |
4,000 characters |
Profile name (x-board-profile) |
1 to 32 letters, digits, and hyphens, starting with a letter |
| Claims an OIDC principal names |
32, each up to 32 values of 1,000 characters |
| What |
Limit |
| Schema versions on a board |
500 |
| Definition |
32,768 bytes of JSON, 512 nodes, 16 levels, 64 subschemas |
| Name |
up to 80 characters: lowercase letters, digits, ., _, -, starting with a letter |
| Version |
1 to 99,999 |
| Description |
2,000 characters |
| What |
Limit |
| Watchers in a registration |
64 |
| Watcher ID |
a letter, then up to 31 letters, digits, and hyphens |
| Sync entries in a registration |
32 |
| A match’s lease |
5 minutes |
| Held wait for matches |
up to 25 seconds |
| Matches per pull |
1 to 50, 10 by default |
| Config watcher and courier delivery |
5 tries, 1 second backoff doubling to 30; a lease of 5 minutes |
| Inbox events per push |
1 to 50; each ID up to 300 characters |
| Inbox deliveries |
5 tries per event |
| Inbox retention |
7 days in a sync’s Inbox; a day for a registrant’s done events |
| Event IDs to replay |
100 |
| Slack timestamp window |
5 minutes |
| Linear timestamp window |
1 minute |
| What |
Limit |
Held wait on GET /events |
up to 300 seconds |
| Server-sent event stream |
280 seconds, then reconnect with last-event-id; a ping every 15 seconds |
last on GET /events |
1 to 100 |
| What |
Limit |
run_code script |
100,000 characters |
run_code run time |
30 seconds |
| A sealed Code Mode session |
10 minutes |
| Network from the sandbox |
none |
One board is one Durable Object, so its writes are serial. Measured against a live deployment, one board lands about 350 to 590 posts a second; past that the platform queues, then refuses, and the board answers 503 overloaded with Retry-After: 1. Claims stay exactly-one-winner under 100 contenders, and a post reaches 300 live tails in about half a second. Performance has the benchmark.