# WithZero Scheduler Task Update (PATCH)

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

Partially updates a scheduled task's notification email, expiry time, allowed tool list (additions only), or raises runtime/spend ceilings

## Facts

- Endpoint: PATCH https://agents.withzero.xyz/api/v1/scheduler/tasks/{id}
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Provider: agents.withzero.xyz
- Website: https://agents.withzero.xyz
- Canonical page: https://www.zero.xyz/c/agents-withzero-xyz-withzero-scheduler-task-update-patch-3da7f6c7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7C2HYXeRBWs5pmrNdLCtZ

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-withzero-scheduler-task-update-patch-3da7f6c7 -d '<json body>'
```

Example prompt: Update my WithZero scheduler task abc123 to notify me at alerts@mycompany.com when it runs, add the 'web_search' tool to its tool list, and extend its end date to 2025-12-31T23:59:59Z.

## When to prefer this

Use this endpoint when you need to modify a live WithZero scheduled task in-place without recreating it — specifically to add notification email, extend expiry, append tools, or raise runtime/spend ceilings. If you need to lower any ceiling or change immutable fields (schedule, env, base spec), you must clone and recreate the task instead. Prefer this over delete+recreate when the task is active and you want to preserve its ID, audit trail, and existing configuration.

## Known failure modes

- 409 RUN_IN_FLIGHT — cannot raise max_runtime_sec while a run is claimed or in progress; retry after the run completes
- 400 validation error — attempting to lower max_runtime_sec or max_sibling_spend_micros (raises only)
- 400 validation error — attempting to remove tools from tool_list (additions only)
- 400 invalid email format for notify_email
- 400 invalid datetime format for end_at
- 404 task not found or caller lacks ownership proof
- 409 conflict if attempting to patch immutable fields

## How this service works

Update notify_email, end_at, or tool_list (additions only). 📖 Full guide: https://scheduler.withzero.xyz/llms.txt

## Output

Returns the updated task object including its UUID, current tool_list, max_sibling_spend_micros, max_runtime_sec, estimated_ceiling_micros, notify_email, and end_at. Immutable fields (like the task spec, env, schedule) are not returned or modified.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "end_at": {
   "anyOf": [
    {
     "type": "string",
     "format": "date-time",
     "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
    },
    {
     "type": "null"
    }
   ]
  },
  "tool_list": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "notify_email": {
   "anyOf": [
    {
     "type": "string",
     "format": "email",
     "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    {
     "type": "null"
    }
   ]
  },
  "max_runtime_sec": {
   "type": "integer",
   "maximum": 900,
   "description": "Raise the per-run wall-clock cap in seconds (max 900). Raises only — lowering forces clone+recreate. 409 RUN_IN_FLIGHT while a run is claimed/running; retry after it finishes. Raising it raises the per-run ceiling reservation — top up if the balance drops below one ceiling.",
   "exclusiveMinimum": 0
  },
  "max_sibling_spend_micros": {
   "type": "string",
   "pattern": "^[1-9]\\d*$",
   "description": "Raise the per-run sibling-spend ceiling (USDC micros; string, or number up to 2^53-1). Raises only — lowering forces clone+recreate."
  }
 },
 "description": "Only `notify_email`, `end_at`, `tool_list` (additions only), `max_sibling_spend_micros` (raises only), and `max_runtime_sec` (raises only, no run in flight) may be patched. All other fields are immutable.",
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "id",
  "tool_list",
  "max_sibling_spend_micros",
  "max_runtime_sec",
  "estimated_ceiling_micros",
  "notify_email",
  "end_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)$"
  },
  "end_at": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "tool_list": {
   "anyOf": [
    {
     "type": "array",
     "items": {
      "type": "string"
     }
    },
    {
     "type": "null"
    }
   ]
  },
  "notify_email": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "max_runtime_sec": {
   "type": "integer",
   "maximum": 9007199254740991,
   "minimum": -9007199254740991
  },
  "estimated_ceiling_micros": {
   "type": "string"
  },
  "max_sibling_spend_micros": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-withzero-xyz-withzero-scheduler-task-update-patch-3da7f6c7/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)