styleAgent

Append Style Agent Batch Items

Append up to 20 more documents to a batch that is still processing.

Rejected with 409 once the batch is sealed (1000 documents reached, or every document has finished) — create a new batch instead. Send an Idempotency-Key header to make retries safe: the same key + payload replays the original 202 instead of appending the documents again.

post/style-agent/batch/{batch_id}/items

Path parameters

batch_idstring required

Headers

Authorizationstring required

Bearer authentication

Idempotency-Keystring nullable

Optional client-generated key making this submission idempotent: a retry with the same key and payload returns the original accepted response instead of submitting the documents again. Reusing a key with a different payload returns 409.

Request body

Response

Documents appended

batch_idstring required
segment_workflow_idstring required
status'running' | 'completed' required

Lifecycle of a style-agent batch (see design-docs/style-agent-batch-checking.md).

A batch is running while any item is non-terminal; it becomes completed (and sealed) once every item reaches a terminal state.

item_countinteger required
created_atstring date-time required

Changes