Sign in
reflex

Poll an async batch

Read a batch's status. request_counts advances as the worker drains the queue; status moves queued → in_progress → completed. Poll on an interval rather than holding a request open.

get/v1/reflex/asynchronous_batches/{batch_id}

Path parameters

batch_idstring required

Identifier returned by the async batch upload.

Example:rbatch-a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d

The batch to poll, as returned in id when you queued it.

Response

Batch status.

idstring required

Identifier for the queued batch.

objectstring required

Object type, always reflex.batch.

status'queued' | 'in_progress' | 'completed' required

Where the batch is in the queue.

created_atinteger required

Unix timestamp (seconds).

Example response

{
  "id": "rbatch-a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
  "object": "reflex.batch",
  "status": "queued",
  "request_counts": {
    "total": 2,
    "completed": 0,
    "failed": 0
  },
  "created_at": 1780000000
}

Changes