{"uid":"cap_xuzIg1yleFkYRqZzA4Le9","slug":"agents-withzero-xyz-stop-task-withzero-scheduler-28842398","name":"Stop Task (WithZero Scheduler)","description":"Stop a task. Direct rail closes the payment channel and refunds remaining escrow. ZeroClick rail releases pending reservations and reports no refund because buyer billing is held by the marketplace. 📖 Full guide: https://scheduler.withzero.xyz/llms.txt","url":"https://agents.withzero.xyz/api/v1/scheduler/tasks/{id}","method":"DELETE","headers":{},"bodySchema":{"type":"object"},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["id","status","billing_rail","channel_close_tx","seller_claimed_micros","buyer_refunded_micros"],"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"},"billing_rail":{"enum":["direct","zeroclick"],"type":"string"},"channel_close_tx":{"anyOf":[{"type":"string"},{"type":"null"}]},"buyer_refunded_micros":{"type":"string"},"seller_claimed_micros":{"type":"string"}},"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_-7r6luWaMluxecVaTu8-k","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":"Stops a scheduled or on-demand task, closing the payment channel and refunding remaining escrow (direct rail) or releasing pending reservations (ZeroClick rail).","exampleAgentPrompt":"Please stop the task with ID 3f2a1b4c-5d6e-7f8a-9b0c-1d2e3f4a5b6c on my WithZero scheduler — close the payment channel and refund whatever escrow is left.","exampleUseCases":[{"title":"Cancel runaway recurring job","prompt":"Cancel the WithZero scheduled task 9e4d2c1a-7b3f-4e5a-8c6d-0f1a2b3c4d5e — it's been running longer than expected and I want to get the remaining escrow back."},{"title":"Stop completed data pipeline task","prompt":"The data pipeline task I set up on WithZero is done early — go ahead and stop task ab12cd34-ef56-7890-abcd-ef1234567890 so the payment channel closes and unused funds are refunded."},{"title":"Terminate ZeroClick marketplace task","prompt":"I need to stop my ZeroClick task 11223344-5566-7788-99aa-bbccddeeff00 on WithZero and release the pending reservations."}],"resultDescription":"Returns a JSON object with the task ID, updated status, billing rail (direct or zeroclick), a channel close transaction hash (or null for ZeroClick), the amount in micros claimed by the seller, and the amount in micros refunded to the buyer.","failureModes":["Task ID not found — 404 with error indicating no matching task","Unauthorized access — task is owner-gated and caller lacks proof","Task already stopped or in terminal state — may return 409 or idempotent response","Invalid UUID format for task ID — 400 validation error","Payment channel closure failure on-chain — may return 500 or partial state"],"whenToPreferThis":"Use this endpoint when you need to explicitly stop a task you previously created via the WithZero scheduler and want to trigger payment settlement — either to close a direct payment channel and reclaim unused escrow, or to release ZeroClick marketplace reservations. Prefer this over simply abandoning a task when cost recovery or clean resource cleanup matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-08-13T21:33:07.338Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-10T00:30:01.926Z","isFirstParty":true}