{"uid":"cap_XKKqGKFVHbZy0aRaKRYjx","slug":"agents-withzero-xyz-withzero-scheduler-async-task-trigger-eeaaf6b1","name":"WithZero Scheduler: Async Task Trigger","description":"Trigger a run asynchronously (non-blocking): pulls next_run_at to now; the dispatch tick runs it within ~1 min. Returns immediately. No-op on non-active tasks. Use POST /tasks/:id/runs for a synchronous run. 📖 Full guide: https://scheduler.withzero.xyz/llms.txt","url":"https://agents.withzero.xyz/api/v1/scheduler/tasks/{id}/trigger","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_zGbsn6kCBa_lcIWwY8K4r","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 a scheduled task by pulling its next run forward to now, returning immediately without waiting for execution.","exampleAgentPrompt":"Trigger my scheduled task with ID a3f1c2d4-5e6b-7890-abcd-ef1234567890 right now without waiting for it to finish — just kick it off in the background.","exampleUseCases":[{"title":"On-demand data pipeline kickoff","prompt":"My nightly data ingestion task is ID b2e4a1d3-9c8f-4321-bcde-012345678901 — can you trigger it right now without waiting for it to complete? I just need it kicked off immediately."},{"title":"Early newsletter dispatch","prompt":"The weekly newsletter task is scheduled for tonight but I want to send it now — the task ID is f7a0c5e2-1b3d-4890-aabc-fedcba987654. Trigger it asynchronously so I don't have to wait."},{"title":"Unblocking a stalled background job","prompt":"My background cleanup job (task ID d9b3f1a2-7e5c-4012-cdef-abcdef123456) seems stuck waiting for its next scheduled run — can you push it to run now and just return immediately?"}],"resultDescription":"Returns a JSON object with the task's UUID, a status string, the updated next_run_at timestamp (or null), and an 'enqueued' boolean indicating whether the task was actually advanced (true if active and triggered, false if the task was not active and the call was a no-op).","failureModes":["Task not found — invalid or unknown UUID returns a 404","Task is not active — returns 200 with enqueued: false (safe no-op)","Unauthorized — missing or invalid ownership proof returns 401/403","Malformed task ID in path — returns 400 validation error","Scheduler service unavailable — returns 5xx"],"whenToPreferThis":"Use this endpoint when you want to trigger a task immediately but do NOT need to wait for execution to complete — ideal for fire-and-forget scenarios, avoiding blocking an agent thread, or when the task may take a long time. If you need the run result synchronously, use POST /tasks/:id/runs instead. If the task may or may not be active, this is still safe to call (no-op on inactive tasks).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:30:22.421Z","isFirstParty":true}