# Trigger Scheduled Task Asynchronously

> Trigger Scheduled Task Asynchronously 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-11).

Asynchronously triggers a scheduled task to run within ~1 minute by pulling its next_run_at time to now, returning immediately without waiting for the result.

## Facts

- Endpoint: POST https://scheduler.withzero.xyz/api/v1/tasks/{id}/trigger
- Price: metered — billed by usage
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-11
- Activations on Zero: 1
- Provider: scheduler.withzero.xyz
- Website: https://scheduler.withzero.xyz
- Canonical page: https://www.zero.xyz/c/scheduler-withzero-xyz-trigger-scheduled-task-asynchronously-777eeea1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3mjJef2GOzWvaAne-2fIW

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-trigger-scheduled-task-asynchronously-777eeea1 -d '<json body>'
```

Example prompt: Go ahead and trigger task 3f2a1b4c-1234-5678-abcd-ef0123456789 to run now — I don't need to wait for the result, just kick it off asynchronously.

## When to prefer this

Use this endpoint when you want to manually trigger a scheduled task to execute soon (within ~1 minute) but do not need to wait for the result. Prefer this over POST /tasks/:id/runs when the task is long-running or when you want a fire-and-forget pattern. Avoid if you need synchronous confirmation that the run completed — use the synchronous runs endpoint instead.

## Known failure modes

- Task ID not found — 404 response if the given task UUID does not exist
- Task not active — returns 200 with enqueued: false as a safe no-op rather than an error
- Invalid UUID format — 400 or validation error if the task ID path parameter is malformed
- Authorization failure — 401/403 if the caller does not own or have permission for the task
- Server error — 500 if the dispatch system is unavailable

## 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_id (UUID), a status string, the updated next_run_at timestamp (or null), and an enqueued boolean — true if the task was active and its run was successfully pulled forward, false if the task was not active and this 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/scheduler-withzero-xyz-trigger-scheduled-task-asynchronously-777eeea1/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)