{"uid":"cap_PeOeSghbGFzUseNjVULiM","slug":"agents-withzero-xyz-withzero-scheduler-synchronous-task-run-20caad38","name":"WithZero Scheduler — Synchronous Task Run","description":"Run a task right now, synchronously: claims, runs the sandbox inline, and blocks until the run finalizes, then returns it. Billed like a normal cron run. Use it to trigger an on-demand run or to test a cron you just set up before trusting the schedule. Does NOT advance next_run_at. 📖 Full guide: https://scheduler.withzero.xyz/llms.txt","url":"https://agents.withzero.xyz/api/v1/scheduler/tasks/{id}/runs","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{},"description":"Empty body. Runs the task immediately and synchronously — blocks until the run finalizes, then returns it.","additionalProperties":false},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["run_id","task_id","status","trigger","claimed_at"],"properties":{"run_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)$"},"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)$"},"trigger":{"type":"string"},"claimed_at":{"type":"string"}},"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_LEd5h712aY-8Pjj2Y-CrG","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":"Immediately claims and executes a scheduled task inline, blocking until the run completes, then returns the finalized run record.","exampleAgentPrompt":"Run my scheduler task with ID a3f1c2d4-89ab-4def-8765-1234567890ab right now and wait for it to finish — I want to verify it works before I rely on the cron schedule.","exampleUseCases":[{"title":"Test a newly created cron job","prompt":"I just set up a cron task with ID b7e2d1a0-1234-4abc-9def-abcdef012345 — can you run it synchronously right now so I can verify it executes correctly before the schedule kicks in?"},{"title":"On-demand report generation","prompt":"Trigger task c9a3b2f1-5678-4bcd-aef0-fedcba987654 immediately and block until it's done — I need the run result before I send the report out."},{"title":"Debug a failing scheduled task","prompt":"My scheduled task e1d4c3b2-9abc-4def-0123-456789abcdef hasn't been working — run it right now synchronously and give me the finalized run status so I can see what happened."}],"resultDescription":"Returns a run record containing: run_id (UUID), task_id (UUID), status string indicating the final run outcome, trigger string indicating how the run was initiated, and claimed_at timestamp showing when the sandbox claimed the task. The response is only returned after the run fully finalizes (blocking).","failureModes":["Task ID not found or caller lacks ownership proof — returns 404 or 403","Task is already running or locked — may return conflict error","Sandbox execution timeout — run may finalize with a failed/timeout status","Invalid UUID format in path parameter — returns 400","Insufficient escrow/payment balance — returns 402"],"whenToPreferThis":"Use this endpoint when you need to run a task immediately and must wait for the result before proceeding — ideal for testing a newly created cron task, debugging a task interactively, or triggering an on-demand execution where the outcome is needed synchronously. Prefer the async trigger endpoint if you don't need to block and just want to fire-and-forget. This endpoint does NOT advance next_run_at, so it won't disrupt your scheduled cadence.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-09-04T21:32:18.937Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-12T06:30:25.732Z","isFirstParty":true}