Skip to main content

Retrieve next queue item

Retrieve and lock the next eligible item from a Datastore queue. The item moves to In progress so other runs do not process it at the same time. Eligibility is determined by priority (lower numbers first), then creation time, along with the configured item status, defer time, and required tags.

Application

  • Queues

Outcomes

NameDescription
SuccessThis status is selected if an eligible item was retrieved and locked.
No resultThis status is selected if no eligible item is available in the queue.
UnsuccessfulThis status is selected if the item could not be retrieved.

Requirements

  • N/A

See the Datastore Queues overview for the full list of queue item fields, the status lifecycle, retrieval order, and common patterns.