{"uid":"cap_2KUKHdS8uCp_qtfE47YVo","slug":"scheduler-withzero-xyz-enqueue-task-for-immediate-execution-non-812cae3e","name":"Enqueue Task for Immediate Execution (Non-Blocking)","description":"DEPRECATED — use POST /tasks/:id/trigger. Behaves identically (async, non-blocking). 📖 Full guide: https://scheduler.withzero.xyz/llms.txt","url":"https://scheduler.withzero.xyz/api/v1/tasks/{id}/enqueue","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{},"description":"Empty body. Triggers a run asynchronously — pulls the task's next run forward to now so the dispatch tick executes it within ~1 minute; returns immediately WITHOUT waiting for the result. Contrast POST /tasks/:id/runs (synchronous). A non-active task is a safe no-op.","additionalProperties":false},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["task_id","status","next_run_at","enqueued"],"properties":{"status":{"type":"string"},"task_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"enqueued":{"type":"boolean","description":"true if next_run_at was pulled forward; false if the task was not active (no-op)."},"next_run_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","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":"metered","summary":"metered — billed by usage","primary":{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_P9hPFRJhwi9v6S67qnYgC","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"scheduler.tasks.enqueue:1"}],"brandName":"scheduler.withzero.xyz","brandSlug":"scheduler-withzero-xyz-mpp","brandBaseUrl":"https://scheduler.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Pulls a scheduled task's next run forward to now so the dispatch tick executes it within ~1 minute, without blocking the caller.","exampleAgentPrompt":"A webhook just came in — go ahead and enqueue task 3f2a1b4c-0000-0000-0000-000000000001 to run within the next minute without waiting for it to finish.","exampleUseCases":null,"resultDescription":"Returns a JSON object with the task's UUID, current status string, the updated next_run_at timestamp (or null), and an 'enqueued' boolean indicating whether the run was actually pulled forward (true) or the task was inactive and this was a no-op (false).","failureModes":["Task ID not found — 404 not found","Task is paused or in terminal state — returns enqueued: false (safe no-op, not an error)","Invalid UUID format — 400 bad request","Unauthorized caller — 401/403 if ownership proof missing","Scheduler service unavailable — 5xx error"],"whenToPreferThis":"Use this endpoint when you need to trigger a task run immediately from an event-driven context (e.g. webhook handler) and do not need to wait for the result. It is ideal for burst event coalescing since multiple calls within the same dispatch tick window collapse into a single run. Prefer this over POST /tasks/:id/runs when you want non-blocking fire-and-forget semantics. For synchronous execution where you need the final run status returned immediately, use the synchronous runs endpoint instead.","instructions":"# Enqueue (DEPRECATED)\n\n## Workflow\n- Use POST /api/v1/tasks/{id}/trigger instead — identical async behavior.","reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-07-28T22:30:13.856Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:30:02.711Z","isFirstParty":true}