{"uid":"cap_DHRxsX4SuGoAZjjq76loV","slug":"scheduler-withzero-xyz-fetch-task-by-id-owner-gated-8b2aaf13","name":"Fetch Task by ID (Owner-Gated)","description":"Fetch a task. Owner-gated by proof. `env` is never returned. 📖 Full guide: https://scheduler.withzero.xyz/llms.txt","url":"https://scheduler.withzero.xyz/api/v1/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","account"],"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":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Direct rail: refundable escrow ceiling. ZeroClick rail: seller-local lifetime execution cap; no buyer money is deposited here. Account rail: null when uncapped (the account credit balance is the real ceiling — see GET /api/v1/owner/usage), else the additional per-task cap."},"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":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Direct rail: remaining escrow. ZeroClick rail: remaining seller-local execution cap, not a refundable monetary balance. Account rail: null in lockstep with max_amount_micros when uncapped."},"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","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"free_handshake","priceSource":"registry","requiresHandshake":true,"reviewCount":2,"rating":{"score":"1.00","successRate":"1.00","reviews":2,"stars":"5.0","state":"rated"},"availabilityStatus":"healthy","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"free · handshake required","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_bSoNKHpvlGSlcPwd-DvXH","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"scheduler.tasks.get:1"}],"brandName":"scheduler.withzero.xyz","brandSlug":"scheduler-withzero-xyz-mpp","brandBaseUrl":"https://scheduler.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Retrieves the full details of a scheduled cron task by its UUID, gated to the task owner via proof; environment variables are never returned.","exampleAgentPrompt":"Can you pull up the full details for my cron task with ID 3f2a1b4c-1234-4abc-89de-000000000001 on the Zero scheduler — I want to see its status, next run time, and how much balance is left in the payment channel?","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the full task record: UUID, owner, status, cron expression, timezone, runtime, entrypoint, source, dependencies, tool list, LLM config, notification email, max runtime seconds, max sibling calls, payment channel ID and transaction hashes, cost metrics (max, cumulative, latest voucher, available balance, estimated ceiling, lifetime cost), lifetime run count, average cost per run, next and last run timestamps, end date, pause reason, recovery hint with top-up instructions if applicable, and created/updated timestamps. The env blob is never included.","failureModes":["401/403 if the caller cannot prove ownership of the task","404 if the task UUID does not exist","400 if the UUID format is invalid","Service unavailable if the scheduler backend is down"],"whenToPreferThis":"Use this endpoint when you need to read the current state, configuration, or cost/billing metrics of a specific scheduled task and you hold proof of ownership. Prefer this over listing endpoints when you already know the task UUID.","instructions":"# Get Task — fetch task spec\n\n## Contract\n- Owner-gated by wallet proof. `env` is never returned (write-only — replace via PUT /api/v1/tasks/{id}/env).","reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1566,"lastUsedAt":"2026-09-15T16:27:32.426Z","lastSuccessfullyRanAt":"2026-09-15T16:27:32.426Z","lastHealthCheckAt":"2026-09-09T03:07:00.216Z","isFirstParty":true}