{"uid":"cap_rrqEv_iCWC9ivcM_I69D9","slug":"scheduler-withzero-xyz-pause-scheduled-task-1d16ede9","name":"Pause Scheduled Task","description":"Manually pause a task. Future runs are skipped until resumed. 📖 Full guide: https://scheduler.withzero.xyz/llms.txt","url":"https://scheduler.withzero.xyz/api/v1/tasks/{id}/pause","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{},"description":"Empty body; pauses the task.","additionalProperties":false},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["id","status","last_paused_reason","last_paused_at"],"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"},"last_paused_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"last_paused_reason":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":1,"rating":{"score":"1.00","successRate":"0.80","reviews":1,"stars":"5.0","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"metered","summary":"metered — billed by usage","primary":{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_BhGZEzYmPTag8G4QBNZKG","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"scheduler.tasks.pause:1"}],"brandName":"scheduler.withzero.xyz","brandSlug":"scheduler-withzero-xyz-mpp","brandBaseUrl":"https://scheduler.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Manually pauses a scheduled cron task so that all future runs are skipped until the task is explicitly resumed.","exampleAgentPrompt":"Pause the scheduled task with ID a3f2c1d0-11ab-4e3a-9b21-000000000001 so it stops running until I resume it.","exampleUseCases":null,"resultDescription":"Returns a JSON object with the task's UUID, updated status (paused), the timestamp when it was last paused (last_paused_at), and the reason for pausing (last_paused_reason), confirming the task will skip all future scheduled runs.","failureModes":["Task ID not found — 404 response if the UUID does not correspond to an existing task","Unauthorized — 401 or 403 if the caller lacks ownership proof for the task","Task already paused — may return a no-op success or a 409 conflict depending on current state","Malformed task ID — 400 if the UUID format is invalid"],"whenToPreferThis":"Use this endpoint when you need to temporarily halt a recurring cron task without deleting it or closing its payment channel. Prefer this over deletion when you plan to resume the task later. This is the right choice when you want to freeze execution due to upstream issues, maintenance windows, or cost control, and intend to call the resume endpoint afterward.","instructions":"# Pause Task\n\n## Workflow\n- Reverse with: POST /api/v1/tasks/{id}/resume\n\n## Contract\n- Future scheduled runs are skipped until resumed. Does NOT refund — use DELETE /api/v1/tasks/{id} to stop + refund.","reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":5,"lastUsedAt":"2026-08-10T23:03:37.385Z","lastSuccessfullyRanAt":"2026-08-10T23:03:37.385Z","lastHealthCheckAt":"2026-09-12T18:30:01.684Z","isFirstParty":true}