Commit 818bfdb
docs(api): the batch cap is embedder-only, not the deployment's to configure (#17185)
`content/docs/api/data-api.mdx` told operators the bulk-route cap is "the
deployment's `batch.maxBatchSize` (default 200, configurable 1-1000)". Both
halves of that were ruled false on 2026-09-07: a `RestServerConfig` is the
ARGUMENT a host passes when it constructs the server, and there is exactly one
door -- `createRestApiPlugin({ api })`, whose `start()` is the only non-test
site reaching `new RestServer(...)`. Neither shipped boot path opens it with a
`batch` config: `os serve` forwards exactly two `api.*` keys and the dev plugin
passes none. A CLI-started deployment therefore always gets 200 and no flag,
config file or CLI option moves it.
The audience of this page is exactly the audience that cannot configure it, so
an operator who hit `400 BATCH_TOO_LARGE` was sent looking for a knob that does
not exist for them.
This is the third and last carrier of the claim still saying it in public; the
`packages/spec` and `packages/rest` carriers were corrected under the same
ruling. The wording here is copied from those two rather than invented afresh
-- "embedder-only", "written only by a host that constructs this config, never
by `os serve` or the dev plugin", and "a CLI-started deployment always gets the
default".
Claude-Session: https://claude.ai/code/session_012GKcPZbMoGq7WPzKLfRBTU
Co-authored-by: Claude <noreply@anthropic.com>1 parent d18b760 commit 818bfdb
1 file changed
Lines changed: 7 additions & 3 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
323 | 323 | | |
324 | 324 | | |
325 | 325 | | |
326 | | - | |
327 | | - | |
328 | | - | |
| 326 | + | |
| 327 | + | |
| 328 | + | |
| 329 | + | |
| 330 | + | |
| 331 | + | |
| 332 | + | |
329 | 333 | | |
330 | 334 | | |
331 | 335 | | |
| |||
0 commit comments