{"uid":"cap_tuua1XZHyLx-bT9qQAwWc","slug":"2s-watcher-cancel-d78b74e7","name":"2s Watcher Cancel","description":"The (most) everything API: 575+ pay-per-call endpoints for AI agents — ground-truth data, a full AI gateway, and agent infrastructure (storage, queues, watchers). USDC via x402, no signup, no API keys, and upto billing: pay actual usage, not the quote.","url":"https://2s.io/api/watchers/cancel","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"watcherId":{"type":"string","maxLength":80,"minLength":8}}},"responseSchema":{"type":"json","schema":{"type":"object","required":["ok","items","total","source"],"properties":{"ok":{"enum":[true],"type":"boolean"},"items":{"type":"array","items":{"type":"object","required":["watcherId","status"],"properties":{"status":{"type":"string"},"watcherId":{"type":"string"}},"additionalProperties":false}},"total":{"type":"integer","nullable":true,"description":"Total matching rows upstream; null when unknown."},"source":{"type":"object","required":["provider","url","license"],"properties":{"url":{"type":"string"},"license":{"type":"string"},"provider":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"example":{"ok":true,"items":[{"status":"example","watcherId":"example"}],"total":1,"source":{"url":"example","license":"example","provider":"example"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0025","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":null,"pricing":{"kind":"static","summary":"$0.0025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LIwkkq9iLlAFgip7-QgbZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Cancels an active watcher subscription by watcherId, stopping further monitoring and associated billing","exampleAgentPrompt":"Cancel the watcher with ID watcher-abc12345 on 2s — I don't need it to keep monitoring anymore.","exampleUseCases":[{"title":"Stop a price alert watcher","prompt":"I set up a watcher to track Bitcoin prices but I don't need it anymore — can you cancel the watcher with ID btc-watch-7f3a9c2d?"},{"title":"Clean up unused monitoring tasks","prompt":"We finished that campaign, so please cancel the watcher bdf82910 on 2s so we stop getting charged for it."},{"title":"Deactivate a weather alert subscription","prompt":"Cancel watcher ID sev-wx-00ab4417 — we've moved past the storm season and don't need those severe weather alerts running anymore."}],"resultDescription":"Returns a JSON object with ok: true, an items array containing the watcherId and its new status (e.g. 'cancelled'), a total count, and a source object with provider, URL, and license metadata.","failureModes":["Invalid or malformed watcherId (too short, too long, or wrong format) returns a validation error","Watcher not found or already cancelled may return an empty items array or error status","Network or payment failure (x402 USDC payment issue) prevents the call from completing","Attempting to cancel a watcher owned by a different session may be rejected"],"whenToPreferThis":"Use this endpoint when you have an active watcher on 2s.io that you want to permanently stop. It is the correct endpoint for cleaning up monitoring subscriptions to avoid unnecessary charges or resource usage. Prefer this over letting watchers expire naturally when immediate termination is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:06:18.554Z","isFirstParty":false}