{"uid":"cap_3mjJef2GOzWvaAne-2fIW","slug":"scheduler-withzero-xyz-trigger-scheduled-task-asynchronously-777eeea1","name":"Trigger Scheduled Task Asynchronously","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://scheduler.withzero.xyz/api/v1/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","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_WpVzDTwYqjo5iil4fumgA","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"scheduler.tasks.trigger:1"}],"brandName":"scheduler.withzero.xyz","brandSlug":"scheduler-withzero-xyz-mpp","brandBaseUrl":"https://scheduler.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Asynchronously triggers a scheduled task to run within ~1 minute by pulling its next_run_at time to now, returning immediately without waiting for the result.","exampleAgentPrompt":"Go ahead and trigger task 3f2a1b4c-1234-5678-abcd-ef0123456789 to run now — I don't need to wait for the result, just kick it off asynchronously.","exampleUseCases":null,"resultDescription":"Returns a JSON object with the task_id (UUID), a status string, the updated next_run_at timestamp (or null), and an enqueued boolean — true if the task was active and its run was successfully pulled forward, false if the task was not active and this was a no-op.","failureModes":["Task ID not found — 404 response if the given task UUID does not exist","Task not active — returns 200 with enqueued: false as a safe no-op rather than an error","Invalid UUID format — 400 or validation error if the task ID path parameter is malformed","Authorization failure — 401/403 if the caller does not own or have permission for the task","Server error — 500 if the dispatch system is unavailable"],"whenToPreferThis":"Use this endpoint when you want to manually trigger a scheduled task to execute soon (within ~1 minute) but do not need to wait for the result. Prefer this over POST /tasks/:id/runs when the task is long-running or when you want a fire-and-forget pattern. Avoid if you need synchronous confirmation that the run completed — use the synchronous runs endpoint instead.","instructions":"# Trigger Task — asynchronous (non-blocking) run\n\n## Workflow\n- Needs a task id from: POST /api/v1/tasks\n- Synchronous alternative (returns the run inline): POST /api/v1/tasks/{id}/runs\n- Read the result after ~1 min: GET /api/v1/runs/{id}, or list via GET /api/v1/tasks/{id}/runs\n\n## Contract\n- Pulls next_run_at to now; the dispatch tick runs it within ~1 min. Returns immediately.\n- No-op on non-active (paused/ended) tasks — resume first via POST /api/v1/tasks/{id}/resume.","reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-07-28T22:30:14.989Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-11T06:44:33.585Z","isFirstParty":true}