{"uid":"cap_sn2ydkuMFcOOw7ygovxP0","slug":"agents-withzero-xyz-withzero-scheduler-fetch-task-by-id-aaa9afae","name":"WithZero Scheduler - Fetch Task by ID","description":"Fetch a task. Owner-gated by proof. `env` is never returned. 📖 Full guide: https://scheduler.withzero.xyz/llms.txt","url":"https://agents.withzero.xyz/api/v1/scheduler/tasks/{id}","method":"GET","headers":{},"bodySchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string"}}},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["id","owner","status","billing_rail","cron","timezone","runtime","entrypoint","source","dependencies","tool_list","llm","notify_email","max_runtime_sec","max_sibling_calls","channel_id","channel_open_tx","channel_close_tx","max_amount_micros","cumulative_cost_micros","latest_voucher_micros","balance_available_micros","estimated_ceiling_micros","lifetime_cost_micros","lifetime_runs","avg_cost_per_run_micros","next_run_at","last_run_at","end_at","last_paused_reason","last_paused_at","recovery_hint","created_at","updated_at"],"properties":{"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)$"},"llm":{"anyOf":[{},{"type":"null"}]},"cron":{"anyOf":[{"type":"string"},{"type":"null"}]},"owner":{"type":"string"},"end_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string"},"status":{"type":"string"},"runtime":{"type":"string"},"timezone":{"type":"string"},"tool_list":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"channel_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Direct rail payment channel/challenge id. Null on the ZeroClick rail."},"created_at":{"type":"string"},"entrypoint":{"type":"string"},"updated_at":{"type":"string"},"last_run_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"next_run_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"billing_rail":{"enum":["direct","zeroclick"],"type":"string"},"dependencies":{"anyOf":[{},{"type":"null"}]},"notify_email":{"anyOf":[{"type":"string"},{"type":"null"}]},"lifetime_runs":{"type":"number"},"recovery_hint":{"anyOf":[{"type":"object","required":["reason","needs_top_up_micros","recommended_top_up_micros","fund_route","delete_route"],"properties":{"reason":{"type":"string"},"fund_route":{"type":"string","description":"Endpoint to call to increase direct escrow or the ZeroClick seller-local execution cap."},"delete_route":{"type":"string","description":"Stop the task. Direct rail refunds remaining escrow; ZeroClick rail has no seller-held balance to refund."},"needs_top_up_micros":{"type":"string","description":"Minimum top_up_amount_micros that would let the task resume."},"recommended_top_up_micros":{"type":"string","description":"Suggested top-up that covers ~10 more worst-case runs."}},"additionalProperties":false},{"type":"null"}],"description":"Populated when status is paused_insufficient_funds. Tells the agent exactly how to recover."},"last_paused_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"channel_open_tx":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Direct rail payment reference. Null on the ZeroClick rail."},"max_runtime_sec":{"type":"number"},"channel_close_tx":{"anyOf":[{"type":"string"},{"type":"null"}]},"max_amount_micros":{"type":"string","description":"Direct rail: refundable escrow ceiling. ZeroClick rail: seller-local lifetime execution cap; no buyer money is deposited here."},"max_sibling_calls":{"type":"number"},"last_paused_reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"lifetime_cost_micros":{"type":"string"},"latest_voucher_micros":{"type":"string"},"cumulative_cost_micros":{"type":"string","description":"Actual finalized run usage plus active reservations, in micros. ZeroClick settlement is reported to the marketplace."},"avg_cost_per_run_micros":{"anyOf":[{"type":"string"},{"type":"null"}]},"balance_available_micros":{"type":"string","description":"Direct rail: remaining escrow. ZeroClick rail: remaining seller-local execution cap, not a refundable monetary balance."},"estimated_ceiling_micros":{"type":"string","description":"Worst-case cost of one run given max_runtime_sec + max_sibling_calls. Compare against balance_available_micros to predict remaining runs."}},"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":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"healthy","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_lwE-gLOVHseczGMSMbVmT","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":"Retrieves full metadata and status for a specific scheduled task, owner-gated by cryptographic proof, with environment variables always omitted from the response.","exampleAgentPrompt":"Can you pull up the full details for my scheduled task with ID 3f5a1b2c-4e6d-7890-abcd-ef1234567890 — I want to see its current status, cron schedule, last run time, and how much it's cost so far?","exampleUseCases":[{"title":"Check why a task was paused","prompt":"My task 9a2b3c4d-1e2f-3a4b-5c6d-7e8f90abcdef got paused — can you fetch it and tell me the last_paused_reason and what the recovery hint says I need to do?"},{"title":"Monitor billing and run history","prompt":"Fetch task b1c2d3e4-f5a6-7b8c-9d0e-1f2a3b4c5d6e for me — I want to see the lifetime run count, average cost per run, and current balance available."},{"title":"Verify cron schedule and next run time","prompt":"Can you look up my scheduled task 00112233-4455-6677-8899-aabbccddeeff and confirm what cron expression it's using, what timezone it's in, and when the next run is scheduled?"}],"resultDescription":"A JSON object containing the full task record including: UUID, owner identifier, status, billing rail (direct or zeroclick), cron expression, timezone, runtime, entrypoint, source, dependencies, tool list, LLM config, notification email, payment channel details (channel_id, open/close tx), cost metrics (max_amount_micros, cumulative cost, latest voucher, available balance, estimated ceiling, lifetime cost), execution stats (lifetime_runs, avg_cost_per_run_micros), scheduling info (next_run_at, last_run_at, end_at), pause metadata (last_paused_reason, last_paused_at, recovery_hint), and audit timestamps. Environment variables are never included in the response.","failureModes":["Task ID not found — 404 if the UUID does not match any existing task","Authorization failure — 401/403 if the caller cannot prove ownership of the task","Invalid UUID format — 400 if the id path parameter is not a valid UUID","Payment/access error — 402 if the x402 payment proof is missing or insufficient","Task deleted — 404 if the task was previously deleted"],"whenToPreferThis":"Use this endpoint when you need the complete current state of a specific known task — its schedule, billing, run history, pause status, and recovery hints. Prefer this over the task list endpoint when you already have the task ID and need deep detail on a single task. This is the right call when debugging a paused or failing task, verifying billing balances, or confirming scheduling configuration before triggering a run.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":152,"lastUsedAt":"2026-09-16T03:00:39.657Z","lastSuccessfullyRanAt":"2026-09-16T03:00:39.657Z","lastHealthCheckAt":"2026-09-15T02:00:01.471Z","isFirstParty":true}