Trigger Agent Batch
Submit up to 50 jobs in a single API call. Per-item validation: bad rows surface as individual errors in the response without blocking the rest…
POST
Submit up to 50 jobs in a single API call.
Per-item validation: bad rows surface as individual errors in the
response without blocking the rest. The whole batch consumes ONE
rate-limit slot and ONE quota check (sized to the count of
well-formed items), so this is the right path for tenants enqueuing
many small tasks at once.
Idempotency. Pass an
Idempotency-Key header to make a batch
replay-safe: a retried call returns the original batch’s job ids and
sets the Idempotency-Replayed: true header. Each item gets a
derived idempotency key of the form
v1.trigger.batch:<your-key>:<index>, so partial replays are
well-defined too.
Request body
BatchTriggerRequest
TriggerRequest[]
required
List of jobs to enqueue (1..50). Each item is validated independently — bad items are rejected per-row, valid items are still accepted and queued.
Response
BatchTriggerResponse
integer
required
Count of successfully queued jobs.
integer
required
Count of rejected items.
BatchTriggerItemResult[]
required
One entry per input item, in original order.