Skip to main content
POST
Create Batch

Authorizations

Authorization
string
header
required

API key in the Authorization header: Bearer qr_live_… or Bearer qr_test_…. Token endpoints take a Clerk session JWT instead.

Body

application/json
items
object[]
required
Required array length: 1 - 1000 elements
design
object

Visual customization. Stored with the code, so the dashboard shows exactly what the API created.

template_id
string

Saved dashboard template id — overrides design.

Response

Batch accepted for processing

id
string
Example:

"batch_aB3dE5fG7hI9jK1m"

object
string
Example:

"batch"

total_count
integer
completed_count
integer
error_count
integer
status
enum<string>
Available options:
processing,
completed,
failed
items
object[]

Present on GET /batches/{id}.

created_at
string<date-time>