{"uid":"cap_3eacVYe7Wbj-xU7ejyI-o","slug":"agents-withzero-xyz-withzero-scheduler-enqueue-task-deprecated-471d3910","name":"WithZero Scheduler Enqueue Task (Deprecated)","description":"DEPRECATED — use POST /tasks/:id/trigger. Behaves identically (async, non-blocking). 📖 Full guide: https://scheduler.withzero.xyz/llms.txt","url":"https://agents.withzero.xyz/api/v1/scheduler/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.000000","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"unknown_unparsed","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":"unknown","summary":"price unknown","primary":{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_9B8d4_MOyvAxGAMpN82hP","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.000000","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.withzero.xyz","brandSlug":"agents-withzero-xyz-mpp","brandBaseUrl":"https://agents.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Asynchronously triggers an immediate run of a scheduled task by pulling its next_run_at forward to now — deprecated alias for POST /tasks/:id/trigger","exampleAgentPrompt":"Kick off my scheduled task with ID a3f2c1d0-1234-4b56-89ab-fedcba987654 right now — don't wait for the result, just trigger it immediately.","exampleUseCases":[{"title":"On-demand data pipeline trigger","prompt":"My nightly data sync task is set to run at midnight but I need it to execute right now — can you enqueue task a3f2c1d0-1234-4b56-89ab-fedcba987654 immediately without waiting for it to finish?"},{"title":"Manual retry after an outage","prompt":"We had a server issue during the scheduled window and task b7e9d2a1-5678-4c89-abcd-ef1234567890 never ran properly — trigger it again right now asynchronously so it catches up."},{"title":"Testing a newly configured job","prompt":"I just set up task c1d2e3f4-9abc-4def-8012-345678abcdef and want to verify it works — can you fire it off immediately without blocking so I can check the logs afterward?"}],"resultDescription":"Returns a JSON object with task_id (UUID), status string, next_run_at (ISO timestamp or null), and enqueued boolean — true if the task's next run was successfully advanced to now, false if the task was inactive (safe no-op). The response arrives immediately without waiting for the task execution to complete.","failureModes":["Task ID not found or not owned by caller — returns 404","Task is not active — returns success with enqueued: false (no-op, not an error)","Invalid UUID format for task ID — returns 400 validation error","Authentication/payment failure — returns 402 or 401","Server error during scheduling state update — returns 500"],"whenToPreferThis":"Use this endpoint only if migrating from older code — new implementations should call POST /tasks/:id/trigger instead, which is the canonical non-deprecated replacement. Both endpoints behave identically: they trigger an async, non-blocking immediate run of a task and return without waiting for execution. Choose this over synchronous run endpoints (POST /tasks/:id/runs) when you do not need to wait for the task result and want fire-and-forget dispatch within ~1 minute.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-12T18:30:01.684Z","isFirstParty":true}