# WithZero Scheduler: Async Task Trigger

> WithZero Scheduler: Async Task Trigger 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).

Asynchronously triggers a scheduled task by pulling its next run forward to now, returning immediately without waiting for execution.

## Facts

- Endpoint: POST https://agents.withzero.xyz/api/v1/scheduler/tasks/{id}/trigger
- 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-async-task-trigger-eeaaf6b1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XKKqGKFVHbZy0aRaKRYjx

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-async-task-trigger-eeaaf6b1 -d '<json body>'
```

Example prompt: Trigger my scheduled task with ID a3f1c2d4-5e6b-7890-abcd-ef1234567890 right now without waiting for it to finish — just kick it off in the background.

## When to prefer this

Use this endpoint when you want to trigger a task immediately but do NOT need to wait for execution to complete — ideal for fire-and-forget scenarios, avoiding blocking an agent thread, or when the task may take a long time. If you need the run result synchronously, use POST /tasks/:id/runs instead. If the task may or may not be active, this is still safe to call (no-op on inactive tasks).

## Known failure modes

- Task not found — invalid or unknown UUID returns a 404
- Task is not active — returns 200 with enqueued: false (safe no-op)
- Unauthorized — missing or invalid ownership proof returns 401/403
- Malformed task ID in path — returns 400 validation error
- Scheduler service unavailable — returns 5xx

## How this service works

Trigger a run asynchronously (non-blocking): pulls next_run_at to now; the dispatch tick runs it within ~1 min. Returns immediately. No-op on non-active tasks. Use POST /tasks/:id/runs for a synchronous run. 📖 Full guide: https://scheduler.withzero.xyz/llms.txt

## Output

Returns a JSON object with the task's UUID, a status string, the updated next_run_at timestamp (or null), and an 'enqueued' boolean indicating whether the task was actually advanced (true if active and triggered, false if the task was not active and the call was a no-op).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {},
 "description": "Empty body. Triggers a run asynchronously — pulls the task's next run forward to now so the dispatch tick executes it within ~1 minute; returns immediately WITHOUT waiting for the result. Contrast POST /tasks/:id/runs (synchronous). A non-active task is a safe no-op.",
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "task_id",
  "status",
  "next_run_at",
  "enqueued"
 ],
 "properties": {
  "status": {
   "type": "string"
  },
  "task_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)$"
  },
  "enqueued": {
   "type": "boolean",
   "description": "true if next_run_at was pulled forward; false if the task was not active (no-op)."
  },
  "next_run_at": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  }
 },
 "additionalProperties": false
}
```

## More

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