{"uid":"cap_DKpmCIPpGIcRgQ6FD8Ekm","slug":"agents-withzero-xyz-resume-a-paused-scheduler-task-3ae95dcd","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://agents.withzero.xyz/api/v1/scheduler/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.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_edy_iNFUG9BQPWDGoWorH","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":"Resumes a paused scheduled task by recomputing its next run time and flipping its status to active, failing with 409 if funds are insufficient.","exampleAgentPrompt":"My scheduled task with ID a3f1b2c4-1234-5678-abcd-ef0123456789 was paused — can you resume it so it starts running again on its normal schedule?","exampleUseCases":[{"title":"Restart task after funding account","prompt":"I just topped up my balance — please resume my paused task a3f1b2c4-1234-5678-abcd-ef0123456789 so it starts running again."},{"title":"Reactivate paused data sync job","prompt":"My nightly data sync task got suspended because funds ran low. I've refilled the account now — go ahead and unpause task b7e2d9f1-4321-8765-dcba-fedcba987654."},{"title":"Resume temporarily paused report automation","prompt":"I manually paused my weekly report task earlier — can you resume task c9a4e8d2-5678-1234-abcd-012345678901 now so it picks back up on schedule?"}],"resultDescription":"Returns a JSON object with the task's UUID, updated status (now 'active'), the recomputed next_run_at timestamp, current balance_available_micros, and estimated_ceiling_micros. Returns 409 TASK_PAUSED_INSUFFICIENT_FUNDS if the available balance is below the estimated cost ceiling.","failureModes":["409 TASK_PAUSED_INSUFFICIENT_FUNDS — balance is below the estimated ceiling; top up funds before retrying","Task not found — invalid or non-existent task UUID returns 404","Authorization failure — caller does not own the task","Task is already active — attempting to resume a non-paused task may return an error","Network timeout or server error returns 5xx"],"whenToPreferThis":"Use this endpoint specifically when a scheduler task is in a paused state and you want to reactivate it. It automatically recomputes the next_run_at time, so you do not need to provide scheduling parameters. Prefer this over creating a new task when the existing task configuration should be preserved. Check balance_available_micros vs estimated_ceiling_micros before calling to avoid the 409 error.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-11T12:30:01.916Z","isFirstParty":true}