Skip to content
Proud to collaborate with Microsoft for Startups

Queue ​

WorkflowTypeDescription
queue.ackAtomicComplete a claimed or running queue item and release its partition key.
queue.claim-nextAtomicLease the next eligible queue item in FIFO order. Skips partition keys that already have an active item and owners at their concurrency cap. Returns claimed=false when nothing is eligible.
queue.drainAtomicAdvance a keyed queue: reap expired leases, reconcile running items against their target runs, then claim and launch up to max_claims new items honouring per-key and per-owner concurrency.
queue.dropAtomicTerminate a queue item without running it, releasing its partition key.
queue.enqueueAtomicAdmit one unit of work into a keyed queue. Applies the admission policy (append / coalesce_latest / reject_duplicate) plus optional debounce, and returns the resulting item and effect.
queue.getAtomicFetch one queue item by uuid, including what superseded it and what it superseded.
queue.listAtomicList queue items for an organization, filtered by queue, key, status or owner.
queue.mark-runningAtomicRecord the run uuid of the workflow launched for a claimed queue item.
queue.nackAtomicRecord a failed attempt for a queue item. Requeues with backoff until the attempt budget is exhausted, then fails terminally.
queue.peekAtomicShow the next eligible item per partition key without claiming it, plus the keys currently blocked by an active item.
queue.reap-leasesAtomicRecover queue items whose lease expired, requeueing them or failing them once their attempt budget is spent. Required for per-key exclusivity to be safe: without it a crashed worker wedges its partition key forever.
queue.requeueAtomicReturn a claimed or running queue item to the queue without consuming an attempt. For leases genuinely lost rather than work that failed.
queue.statsAtomicAggregate queue depth by status, plus the deepest partition keys.