{"uid":"cap_juWRNXbiRBTW5ylYXesfw","slug":"zenvault-pull-based-work-queue-0d34c4de","name":"ZenVault Pull-Based Work Queue","description":"Pull-based work queue with leases; timed-out leases requeue.","url":"https://api.zenvault.eu/v1/queues?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PMZo0s87v025-_qWENuMb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates a pull-based work queue with lease-based task distribution, automatically requeueing tasks whose leases expire before completion.","exampleAgentPrompt":"Set up a pull-based work queue called 'image-processing-jobs' with a 60-second lease timeout so that if a worker crashes mid-task, the job automatically comes back for another worker to pick up.","exampleUseCases":[{"title":"Agent fleet task distribution","prompt":"Create a work queue called 'data-scraping-tasks' with a 30-second lease timeout so my fleet of scraper agents can each pull jobs one at a time without stepping on each other, and any job a crashed agent was holding gets requeued automatically."},{"title":"Resilient background job pipeline","prompt":"I need a pull queue called 'report-generation' with a 120-second lease timeout — my report workers sometimes time out on large files and I need those jobs to automatically go back into the queue for a retry."},{"title":"Multi-step workflow coordination","prompt":"Set up a task queue named 'order-fulfillment-steps' with a 45-second lease so I can have multiple worker agents each claim one order step at a time, and if any agent goes offline mid-step the task gets reclaimed and reprocessed."}],"resultDescription":"Returns the newly created queue resource (with its ID and configuration) plus a one-time management token that can be used to administer the queue (delete it, inspect it, or modify settings). The management token is only returned at creation time and must be stored securely.","failureModes":["Invalid or missing lease timeout configuration returns a 400 error","Duplicate queue name conflict if queue already exists","Payment failure via x402 protocol blocks queue creation","Management token lost if not captured at creation — cannot be re-retrieved","Queue not found if management token is used after queue expiry or deletion"],"whenToPreferThis":"Choose this endpoint when you need a durable, pull-based work queue where multiple agent workers independently claim tasks and lease timeouts protect against lost work from crashes or hangs. It is especially appropriate for distributed agent workflows running on ZenVault's infrastructure, where sibling services (key-value storage, webhook buffering, run-state resumption) are also in use. Prefer it over a simple message queue when automatic lease expiry and requeue semantics are required — i.e., when you cannot guarantee that every worker will acknowledge completion.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T04:16:47.265Z","isFirstParty":false,"canonicalSlug":"zenvault-pull-based-work-queue-0d34c4de"}