Bulk Calculate
Create and solve up to 100 sheets in one project in a single call. The request is accepted whole or rejected whole: if any item is invalid, 422 lists every item’s errors and nothing is created. On 201 the sheets are being created and solved; poll the Location header until state is completed or failed. One batch runs per project at a time: a request while one is running returns 409 naming the batch to poll.
Authorizations
Headers
Body
Response
The batch was accepted and is being processed.
A bulk-calculate batch. The same body is returned when the batch is accepted and on every poll; items is null until state is terminal. Clients must tolerate state values not listed here.
processing while sheets are being created and solved. completed once every item has an outcome; items that could not be solved carry their own error, so a completed batch can have summary.solved of 0. failed when the batch itself could not run, or when it stopped before finishing and will not resume (see error). Treat an unrecognised value as still in progress.
Counts over the items. pending is total - solved - errored - stale and is 0 once the batch is terminal, where every item is solved or carries an error. The three non-solved counters answer different questions and are never folded together, because the remedy differs: errored counts items the batch could not produce results for, where retrying is the fix; stale counts items it did solve whose inputs have changed since, where nothing failed and re-solving the sheet is the fix; checkErrored counts items that solved but whose governing check produced no verdict, and those are also counted in solved. To confirm every item is usable, check errored, stale and checkErrored are all 0. state is the completion signal. While processing the counts are progress, and pending can read 0 in the moments between the last sheet solving and the batch reaching a terminal state; do not use it to detect completion. On a terminal batch the counters are recomputed from the sheets' current state on every poll, so the same batchId can report different counts later if its sheets are edited or deleted.