{"uid":"cap_DzHCtAuEenflkTQmmhiXq","slug":"agents-withzero-xyz-pause-scheduled-task-6a28542d","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://agents.withzero.xyz/api/v1/scheduler/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.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_WPL2dm8NGIox5PSmgU7PV","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":"Pauses a scheduled task by ID, causing all future runs to be skipped until the task is explicitly resumed.","exampleAgentPrompt":"Pause task a3f2c1d0-1234-4abc-89ef-56789abcdef0 on WithZero Scheduler — I want future runs skipped until I say to resume it.","exampleUseCases":[{"title":"Suspend pipeline during maintenance window","prompt":"Pause the scheduled data pipeline task with ID b7e9a2c1-0011-4fde-aabc-99887766aabb so it doesn't fire while we're doing database maintenance this weekend."},{"title":"Hold recurring report during vacation","prompt":"I'm going on vacation for two weeks — can you pause my weekly report task c1d2e3f4-5678-4abc-90ef-aabbccddeeff so nothing runs while I'm away?"},{"title":"Freeze failing job to stop error alerts","prompt":"Pause task 00112233-4455-4abc-8899-aabbccddeeff right now — it keeps failing and I need to stop the error spam until the underlying issue is fixed."}],"resultDescription":"Returns a JSON object confirming the task is paused, including the task's UUID, updated status string, the timestamp when it was paused (last_paused_at), and the reason for the pause (last_paused_reason), which may be null for manual pauses.","failureModes":["Task ID not found or not owned by caller — returns 404 or 403","Task is already paused — may return a no-op success or a conflict response","Invalid UUID format in path — returns 400 validation error","Authentication/payment failure — returns 402 or 401 if escrow is insufficient or identity is unverified"],"whenToPreferThis":"Use this endpoint when you need to temporarily halt a recurring or scheduled task without deleting it, preserving its configuration for future resumption. Prefer this over deletion when the task will be needed again and you simply want to skip upcoming runs during a maintenance window, debugging session, or planned downtime.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-11T12:38:25.102Z","isFirstParty":true}