# Resume a Paused Scheduler Task

> Resume a Paused Scheduler Task is a paid API for AI agents from agents.withzero.xyz, paid per call via MPP, price unknown, status unknown (last checked 2026-09-11).

Resumes a paused scheduled task by recomputing its next run time and flipping its status to active, failing with 409 if funds are insufficient.

## Facts

- Endpoint: POST https://agents.withzero.xyz/api/v1/scheduler/tasks/{id}/resume
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-11
- Activations on Zero: 0
- Provider: agents.withzero.xyz
- Website: https://agents.withzero.xyz
- Canonical page: https://www.zero.xyz/c/agents-withzero-xyz-resume-a-paused-scheduler-task-3ae95dcd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DKpmCIPpGIcRgQ6FD8Ekm

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-withzero-xyz-resume-a-paused-scheduler-task-3ae95dcd -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Resume a paused task. 409 TASK_PAUSED_INSUFFICIENT_FUNDS if balance < ceiling. 📖 Full guide: https://scheduler.withzero.xyz/llms.txt

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
}
```

## Response schema (JSON Schema)

```json
{
 "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
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-withzero-xyz-resume-a-paused-scheduler-task-3ae95dcd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.withzero.xyz](https://www.zero.xyz/host/agents.withzero.xyz/llms.txt)