{"uid":"cap_VrNV5pGPu0UmNtLD1-caC","slug":"agents-withzero-xyz-withzero-scheduler-cross-task-usage-rollup-599d3b1a","name":"WithZero Scheduler Cross-Task Usage Rollup","description":"Cross-task usage rollup for the caller. current_balance_micros is refundable escrow on the direct rail and a non-refundable seller-local execution cap on the ZeroClick rail. 📖 Full guide: https://scheduler.withzero.xyz/llms.txt","url":"https://agents.withzero.xyz/api/v1/scheduler/owner/usage","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["billing_rail","total_spend_micros","total_runs","current_balance_micros","top_tasks","next_cursor"],"properties":{"top_tasks":{"type":"array","items":{"type":"object","required":["task_id","lifetime_cost_micros","lifetime_runs"],"properties":{"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)$"},"lifetime_runs":{"type":"number"},"lifetime_cost_micros":{"type":"string"}},"additionalProperties":false}},"total_runs":{"type":"number"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"billing_rail":{"enum":["direct","zeroclick"],"type":"string"},"total_spend_micros":{"type":"string"},"current_balance_micros":{"type":"string","description":"Direct rail: aggregate remaining escrow. ZeroClick rail: aggregate remaining seller-local execution cap, not refundable money."}},"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_Q1DjxPOkNpUscGyVgnXhn","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 an aggregated usage summary for the caller across all scheduled tasks, including total spend, total runs, current balance, and top tasks by cost.","exampleAgentPrompt":"Show me my overall usage rollup across all my WithZero scheduler tasks — I want to see total spend, current balance, total runs, and which tasks have cost the most.","exampleUseCases":[{"title":"Monitor agent spending across tasks","prompt":"How much have all my scheduled tasks spent in total on WithZero, and what's my current escrow balance? Show me the top tasks by cost."},{"title":"Check ZeroClick execution cap remaining","prompt":"What's my remaining execution cap on the ZeroClick rail for my WithZero scheduler account, and how many total runs have completed?"},{"title":"Audit top tasks by lifetime cost","prompt":"Pull up my WithZero scheduler usage summary and tell me which tasks have the highest lifetime cost and how many times each has run."}],"resultDescription":"A JSON object containing the billing rail type (direct or zeroclick), total spend in micros, total number of runs, current balance in micros (escrow for direct rail, non-refundable execution cap for ZeroClick), a paginated list of top tasks each with task UUID, lifetime cost in micros, and lifetime run count, plus a next_cursor for pagination.","failureModes":["Unauthorized: caller proof missing or invalid, returns 401","No tasks found: returns empty top_tasks array and zero totals","Pagination cursor invalid or expired, returns 400","Network timeout if scheduler backend is overloaded","Rate limiting if polled too frequently"],"whenToPreferThis":"Use this endpoint when you need a cross-task aggregate view of spending, run counts, and balances for the authenticated caller — rather than per-task or per-run detail endpoints. It is the right choice for billing dashboards, cost monitoring, and understanding overall scheduler usage before drilling into individual task audits.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:46:33.195Z","isFirstParty":true}