{"uid":"cap_emjfDLj6H8KP9k9PGeGDt","slug":"agents-withzero-xyz-withzero-scheduler-get-single-run-details-b89c7633","name":"WithZero Scheduler - Get Single Run Details","description":"Deep-dive single run with truncated stdout/stderr + logs_url. 📖 Full guide: https://scheduler.withzero.xyz/llms.txt","url":"https://agents.withzero.xyz/api/v1/scheduler/runs/{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","task_id","status","trigger","started_at","finished_at","claimed_at","heartbeat_at","exit_code","stdout","stderr","cost_daytona_micros","cost_overhead_micros","cost_siblings_micros","cost_total_micros","sibling_call_count","daytona_sandbox_id","logs_url","artifacts"],"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)$"},"status":{"type":"string"},"stderr":{"anyOf":[{"type":"string"},{"type":"null"}]},"stdout":{"anyOf":[{"type":"string"},{"type":"null"}]},"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"},"logs_url":{"type":"string"},"artifacts":{"type":"array","items":{"type":"object","required":["name","url","path","bytes","content_type","created_at"],"properties":{"url":{"type":"string"},"name":{"type":"string"},"path":{"type":"string"},"bytes":{"type":"number"},"created_at":{"type":"string"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},"description":"Durable artifacts stored by the run via the cdn capability. Fetchable by URL."},"exit_code":{"anyOf":[{"type":"number"},{"type":"null"}]},"claimed_at":{"type":"string"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"finished_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"heartbeat_at":{"type":"string"},"cost_total_micros":{"anyOf":[{"type":"string"},{"type":"null"}]},"daytona_sandbox_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"sibling_call_count":{"type":"number"},"cost_daytona_micros":{"anyOf":[{"type":"string"},{"type":"null"}]},"cost_overhead_micros":{"anyOf":[{"type":"string"},{"type":"null"}]},"cost_siblings_micros":{"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.50","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_As-NAvp2kpUg_GkjqgNsJ","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 detailed information about a single scheduled task run, including truncated stdout/stderr output, a logs URL for full logs, artifacts, cost breakdown, and execution metadata.","exampleAgentPrompt":"Can you pull up the details for run ID 3f6a1b2c-4d5e-6789-abcd-ef0123456789 — I want to see its status, exit code, any stdout/stderr output, and a link to the full logs?","exampleUseCases":[{"title":"Diagnose a failed scheduled job","prompt":"That nightly data pipeline run failed — can you look up run 7e4c9f12-1a2b-3c4d-8e5f-6a7b8c9d0e1f and tell me the exit code, what showed up in stderr, and where I can find the full logs?"},{"title":"Confirm a triggered run completed successfully","prompt":"I just triggered a task and got a run ID back: b2d4f6a8-1c3e-5g7i-9k0m-2n4p6r8t0v1x — can you check if it finished successfully and show me what it printed to stdout?"},{"title":"Review cost breakdown for a compute run","prompt":"I need to see how much run a1b2c3d4-e5f6-7890-abcd-ef1234567890 cost — break it down by daytona, overhead, and sibling calls so I can understand the billing."}],"resultDescription":"Returns a JSON object with the run's UUID, associated task ID, status string, trigger source, timestamps (started_at, finished_at, claimed_at, heartbeat_at), exit code, truncated stdout and stderr strings, a logs_url pointing to full log output, an array of durable artifacts (each with name, URL, path, bytes, content_type, created_at), cost figures in micros (daytona, overhead, siblings, total), the Daytona sandbox ID, and a count of sibling API calls made during the run.","failureModes":["Run ID not found or does not belong to caller — 404 or 403 response","Invalid UUID format for id parameter — 400 validation error","Run not yet started — timestamps and exit_code may be null","stdout/stderr truncated — full output only available via logs_url","Payment or authentication failure — 402 or 401 response"],"whenToPreferThis":"Use this endpoint when you need detailed execution metadata for a specific run by its UUID — including cost breakdown, artifacts, and a link to full logs. Prefer this over a run-list endpoint when you already have the run ID and need deep diagnostic information rather than a paginated summary.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":2,"lastUsedAt":"2026-09-04T21:34:37.110Z","lastSuccessfullyRanAt":"2026-09-04T21:34:37.110Z","lastHealthCheckAt":"2026-09-14T12:39:34.525Z","isFirstParty":true}