{"uid":"cap_ge8EFcVMMj2hZv2RTKTbN","slug":"agents-withzero-xyz-list-task-runs-cursor-paginated-75106723","name":"List Task Runs (Cursor-Paginated)","description":"Slim per-run rows, cursor-paginated (limit ≤50). 📖 Full guide: https://scheduler.withzero.xyz/llms.txt","url":"https://agents.withzero.xyz/api/v1/scheduler/tasks/{id}/runs","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":["runs","next_cursor"],"properties":{"runs":{"type":"array","items":{"type":"object","required":["id","status","started_at","finished_at","exit_code","cost_total_micros","sibling_call_count","trigger"],"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"},"trigger":{"type":"string"},"exit_code":{"anyOf":[{"type":"number"},{"type":"null"}]},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"finished_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"cost_total_micros":{"anyOf":[{"type":"string"},{"type":"null"}]},"sibling_call_count":{"type":"number"}},"additionalProperties":false}},"next_cursor":{"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":"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_wxN8Wd84twhdv2A5y4W5u","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":"Returns a paginated list of slim per-run rows for a given scheduled task, including status, timing, cost, and trigger info, with cursor-based pagination up to 50 runs per page.","exampleAgentPrompt":"Show me the last 50 runs for task ID a1b2c3d4-e5f6-7890-abcd-ef1234567890 — I want to see their statuses, when they started and finished, exit codes, and how much each one cost.","exampleUseCases":[{"title":"Audit recurring task execution history","prompt":"Pull up the run history for my scheduled task a1b2c3d4-e5f6-7890-abcd-ef1234567890 — I want to see which runs succeeded, which failed, and what each one cost."},{"title":"Monitor task failures in a workflow","prompt":"Check the recent runs for task 7f8e9d0c-1b2a-3c4d-5e6f-7a8b9c0d1e2f and tell me if any of them had a non-zero exit code or didn't finish."},{"title":"Page through long task run log","prompt":"Get the next page of runs for task 3c4d5e6f-7a8b-9c0d-1e2f-3a4b5c6d7e8f using cursor eyJpZCI6IjEyMyJ9 — I need to go back further in the execution history."}],"resultDescription":"Returns a JSON object containing an array of slim run rows (each with UUID, status string, trigger type, exit code, started_at, finished_at, cost_total_micros, and sibling_call_count) plus a next_cursor string (or null if no more pages) for cursor-based pagination.","failureModes":["Task ID not found or not owned by caller — returns 404 or 403","Invalid cursor value causes pagination error — returns 400","Limit exceeds 50 — may return 400 or be silently capped","Task ID missing from path — returns 422 or 400","Network or upstream scheduler error — returns 500"],"whenToPreferThis":"Use this endpoint when you need to paginate through the execution history of a specific scheduled task and want lightweight row data (status, timing, cost, exit code) without full stdout/stderr logs. For a deep-dive into a single run's output, use the single-run detail endpoint instead. Prefer this endpoint when auditing cost, monitoring failure rates, or iterating through large run histories efficiently.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-09-04T21:33:28.104Z","lastSuccessfullyRanAt":"2026-09-04T21:33:28.104Z","lastHealthCheckAt":"2026-09-14T12:42:56.553Z","isFirstParty":true}