# Pause Scheduled Task

> Pause Scheduled 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).

Pauses a scheduled task by ID, causing all future runs to be skipped until the task is explicitly resumed.

## Facts

- Endpoint: POST https://agents.withzero.xyz/api/v1/scheduler/tasks/{id}/pause
- 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-pause-scheduled-task-6a28542d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DzHCtAuEenflkTQmmhiXq

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-pause-scheduled-task-6a28542d -d '<json body>'
```

Example prompt: Pause task a3f2c1d0-1234-4abc-89ef-56789abcdef0 on WithZero Scheduler — I want future runs skipped until I say to resume it.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Manually pause a task. Future runs are skipped until resumed. 📖 Full guide: https://scheduler.withzero.xyz/llms.txt

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {},
 "description": "Empty body; pauses the task.",
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-withzero-xyz-pause-scheduled-task-6a28542d/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)