{"uid":"cap_b5FgKrF4w8j0cFPBSLt8b","slug":"agents-withzero-xyz-withzero-scheduler-task-fund-top-up-d566bcd1","name":"WithZero Scheduler Task Fund (Top-Up)","description":"Increase max_amount_micros. Direct endpoint: X-Pay-Amount-Micros must match top_up_amount_micros and the settled payment extends refundable escrow; no Idempotency-Key header required because replay protection is payment-bound. ZeroClick endpoint: the amount only raises the seller-local lifetime execution cap; marketplace usage remains authoritative and no seller escrow moves. 📖 Full guide: https://scheduler.withzero.xyz/llms.txt","url":"https://agents.withzero.xyz/api/v1/scheduler/tasks/{id}/fund","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["top_up_amount_micros"],"properties":{"top_up_amount_micros":{"type":"string","pattern":"^[1-9]\\d*$","description":"Additional USDC to add to the task, in micros (1 USDC = 1_000_000 micros; string or number up to 2^53-1). Bumped onto max_amount_micros."}},"description":"Top up a task to extend its runway. Use when a task is `paused_insufficient_funds` or you want a margin before it pauses.","additionalProperties":false},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["id","status","max_amount_micros","cumulative_cost_micros","balance_available_micros","estimated_ceiling_micros","topped_up_micros","billing_rail","fund_tx_hash"],"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","description":"New status — flips from 'paused_insufficient_funds' to 'active' if the top-up covers the ceiling."},"billing_rail":{"enum":["direct","zeroclick"],"type":"string"},"fund_tx_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Direct rail: on-chain channel id. ZeroClick rail: null because no seller escrow moved."},"topped_up_micros":{"type":"string"},"max_amount_micros":{"type":"string","description":"New cap after the top-up."},"cumulative_cost_micros":{"type":"string"},"balance_available_micros":{"type":"string"},"estimated_ceiling_micros":{"type":"string"}},"description":"Top-up confirmation. The new balance covers (max_amount - cumulative_cost); compare against estimated_ceiling_micros to see how many runs the topped-up balance can still cover.","additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"1","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":{"amountUsd":"1.00","asset":"USDC"},"pricing":{"kind":"session","summary":"$1/call","primary":{"kind":"session","protocol":"mpp","network":"tempo","amountUsd":"1","per":"call","confidence":"exact","depositUsd":"1.00"},"accepted":[{"kind":"session","protocol":"mpp","network":"tempo","amountUsd":"1","per":"call","confidence":"exact","depositUsd":"1.00"},{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cVcxKmWDlAKL9Z60sQOug","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"session","costAmount":"1","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":1000000,"planRef":null},{"uid":"pm_fV51fBccoWwRZi5NOlzUz","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":"usd","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.withzero.xyz","brandSlug":"agents-withzero-xyz-mpp","brandBaseUrl":"https://agents.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Increases the maximum USDC budget for an existing scheduled task by adding funds to its escrow or raising its execution cap.","exampleAgentPrompt":"My scheduled task abc123 is paused because it ran out of funds — can you top it up with 5 USDC so it can keep running?","exampleUseCases":[{"title":"Resume paused task with fresh funds","prompt":"My recurring research task (ID: e3f7a1b2-...) paused because it hit its budget limit — please add 10 USDC to it so it resumes automatically."},{"title":"Add runway before funds run out","prompt":"I want to top up my scheduled data-publishing task by 3 USDC while it still has some balance, so it doesn't pause mid-cycle."},{"title":"Extend execution cap for high-frequency task","prompt":"My agent task is running more often than expected — can you add 20 USDC worth of runway to task ID 9d4c2e88-... so it doesn't get blocked?"}],"resultDescription":"Returns the updated task object including: new max_amount_micros (raised cap), current status (may flip from paused_insufficient_funds to active), balance_available_micros, topped_up_micros, estimated_ceiling_micros (projected runs remaining), billing_rail (direct or zeroclick), and fund_tx_hash (on-chain channel ID for direct rail, null for zeroclick).","failureModes":["400 PRICE_RESOLVER_FAILED — X-Pay-Amount-Micros header missing, non-integer, or does not exactly match top_up_amount_micros body field","404 — task ID not found or caller does not own the task","402 — payment challenge not settled; funds not transferred","422 — top_up_amount_micros is zero or negative (pattern requires non-zero positive integer string)","503 — upstream payment rail or escrow service temporarily unavailable"],"whenToPreferThis":"Use this endpoint when an existing WithZero scheduled task has paused due to insufficient funds (status: paused_insufficient_funds) or when you want to proactively add USDC runway before the task's balance is exhausted. This is the only endpoint for increasing a task's budget cap after creation — use the task-create endpoint if starting fresh. On the direct rail, funds move into on-chain refundable escrow; on the zeroclick rail, only the local execution cap is raised.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-11T06:41:39.827Z","isFirstParty":true}