# Pause Scheduled Task

> Pause Scheduled Task is a paid API for AI agents from scheduler.withzero.xyz, paid per call via MPP, metered — billed by usage, status unknown (last checked 2026-09-12, last successful call 2026-08-10).

Manually pauses a scheduled cron task so that all future runs are skipped until the task is explicitly resumed.

## Facts

- Endpoint: POST https://scheduler.withzero.xyz/api/v1/tasks/{id}/pause
- Price: metered — billed by usage
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-12
- Last successful call: 2026-08-10
- Success rate: 80% of calls made through Zero
- Rating: 5.0 / 5 from 1 review
- Activations on Zero: 5
- Provider: scheduler.withzero.xyz
- Website: https://scheduler.withzero.xyz
- Canonical page: https://www.zero.xyz/c/scheduler-withzero-xyz-pause-scheduled-task-1d16ede9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rrqEv_iCWC9ivcM_I69D9

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 scheduler-withzero-xyz-pause-scheduled-task-1d16ede9 -d '<json body>'
```

Example prompt: Pause the scheduled task with ID a3f2c1d0-11ab-4e3a-9b21-000000000001 so it stops running until I resume it.

## When to prefer this

Use this endpoint when you need to temporarily halt a recurring cron task without deleting it or closing its payment channel. Prefer this over deletion when you plan to resume the task later. This is the right choice when you want to freeze execution due to upstream issues, maintenance windows, or cost control, and intend to call the resume endpoint afterward.

## Known failure modes

- Task ID not found — 404 response if the UUID does not correspond to an existing task
- Unauthorized — 401 or 403 if the caller lacks ownership proof for the task
- Task already paused — may return a no-op success or a 409 conflict depending on current state
- Malformed task ID — 400 if the UUID format is invalid

## 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 with the task's UUID, updated status (paused), the timestamp when it was last paused (last_paused_at), and the reason for pausing (last_paused_reason), confirming the task will skip all future scheduled runs.

## 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/scheduler-withzero-xyz-pause-scheduled-task-1d16ede9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from scheduler.withzero.xyz](https://www.zero.xyz/host/scheduler.withzero.xyz/llms.txt)