Declared v1 limits
| Input | Contract |
|---|---|
| Query limit | 1–1,000 rows; default 100 |
| Projected fields | At most 100 field names |
| Download format | jsonl, csv, or parquet |
| API major header | X-API-Version defaults to 1 |
Let the response control retry timing
A 429 response may include Retry-After in seconds. Wait at least that long and add jitter. The public contract does not promise fixed workspace request quotas, so do not hard-code an assumed requests-per-second value.
Bound concurrency at the client
Use a small worker pool and queue excess work. Separate build polling from query traffic so a degraded build does not consume all client capacity. Apply an overall deadline in addition to individual request timeouts.
Choose the correct transport
| Need | Use |
|---|---|
| Interactive preview | Bounded query with selected fields |
| Complete release import | Streaming download |
| Build status | GET one build with bounded polling |
| Catalog refresh | Conditional scheduled GET in your application |