{"uid":"cap_UeO9ceiGuSYmFH_6sZACu","slug":"scheduler-withzero-xyz-resume-a-paused-scheduler-task-1ceaefa4","name":"Resume a Paused Scheduler Task","description":"Resume a paused task. 409 TASK_PAUSED_INSUFFICIENT_FUNDS if balance < ceiling. 📖 Full guide: https://scheduler.withzero.xyz/llms.txt","url":"https://scheduler.withzero.xyz/api/v1/tasks/{id}/resume","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{},"description":"Empty body; recomputes next_run_at and flips status to active.","additionalProperties":false},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["id","status","next_run_at","balance_available_micros","estimated_ceiling_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"},"next_run_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"balance_available_micros":{"type":"string"},"estimated_ceiling_micros":{"type":"string"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","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":"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_g5XFSF6yBbibPTFx9hN25","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"scheduler.tasks.resume:1"}],"brandName":"scheduler.withzero.xyz","brandSlug":"scheduler-withzero-xyz-mpp","brandBaseUrl":"https://scheduler.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Resumes a paused cron task, recomputes its next run time, and flips its status back to active — failing with 409 if balance is below the cost ceiling.","exampleAgentPrompt":"My scheduled task with ID a3f7c2b1-0e4d-4a1c-9b5e-123456789abc was paused — please resume it so it runs again on its normal cron schedule.","exampleUseCases":null,"resultDescription":"Returns a JSON object with the task's UUID, updated status (active), recomputed next_run_at timestamp, current balance_available_micros, and estimated_ceiling_micros. If the available balance is less than the cost ceiling, the call fails with HTTP 409 and error code TASK_PAUSED_INSUFFICIENT_FUNDS.","failureModes":["409 TASK_PAUSED_INSUFFICIENT_FUNDS — balance_available_micros is below estimated_ceiling_micros; top up funds before resuming","404 Not Found — task ID does not exist or caller lacks ownership proof","403 Forbidden — caller is not the task owner","400 Bad Request — malformed or missing task UUID in path","Task resumes but next_run_at is computed in the past, causing an immediate run on next scheduler tick"],"whenToPreferThis":"Use this endpoint specifically when a task is in a paused state and you want to bring it back to active scheduling. It is the correct endpoint after manually pausing a task via the pause endpoint, or after a task was auto-paused due to insufficient funds and has since been topped up. Do not use this for creating new tasks or modifying task parameters.","instructions":"# Resume Task\n\n## Workflow\n- Undo of: POST /api/v1/tasks/{id}/pause\n- Check before resuming: GET /api/v1/tasks/{id} → balance_available_micros vs estimated_ceiling_micros\n\n## Contract\n- 409 TASK_PAUSED_INSUFFICIENT_FUNDS if balance < one run's ceiling → top up first: POST /api/v1/tasks/{id}/fund.","reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-07-28T22:30:14.892Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:40:56.495Z","isFirstParty":true}