queue.consumer automation events are triggered by the Background Queue scheduler to process a batch of messages from an automation-backed queue.

The batch size is configured per queue – use 1 for expensive per-message operations, or 10-100+ to amortize batch operations.

Placeholders

The automation event dictionary starts with the following values:

Key Type Notes
queue_* record The queue being consumed. Supports key expansion.
queue_job_* record The queue job that owns this batch, if any. Supports key expansion.
messages array An array of {uuid, message, available_at, job_id} dicts for the batch.

Outputs

(none)

Any non-error response is treated as successful delivery of the entire batch. If the automation returns an error: outcome, the messages are marked failed and retried per the queue's retry policy.