{"uid":"cap_b5FgKrF4w8j0cFPBSLt8b","slug":"agents-withzero-xyz-withzero-scheduler-task-fund-top-up-d566bcd1","name":"WithZero Scheduler Task Fund (Top-Up)","description":"Create media, research companies and people, publish to the web, remember context, deploy apps, and schedule work—on demand, without vendor accounts or API keys. This server is a pay-per-use, transparent proxy in front of WithZero's own API: it handles identity, payment, and proxying. Agents can purchase autonomously or with their human's approval. Operations whose x-payment-info.access is \"plan\" are sold on plans, not per call: they answer an unidentified call with 401 and an identified call with no covering plan with 403, never a 402. The complete verified paid surface is listed at /openapi.json, the source of truth for available operations. Each operation here carries its pricing in x-payment-info. Use the operations and details here when they meet your needs. Filtered specs contain only matching operations; if you cannot find what you need here, use search or the service catalog. The live catalog at /manifest.json is authoritative for prices and any free included units (prices[].includedUnits) - some meters include free usage per account before any charge, reserved for agents claimed by a human with a verified email.","url":"https://agents.withzero.xyz/api/v1/scheduler/tasks/{id}/fund?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"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","account"],"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":["x402"],"displayCostAmount":"1","displayCostAsset":"USDC","priceDynamic":false,"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":"static","protocol":"mpp","network":"tempo","amountUsd":"1","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","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},{"uid":"pm_4hKbDjEToqeFOG8y1J-0h","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.withzero.xyz","brandSlug":"agents-withzero-xyz-x402","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-11-01T00:30:06.809Z","isFirstParty":true,"canonicalSlug":"agents-withzero-xyz-withzero-scheduler-task-fund-top-up-d566bcd1"}