# WithZero Scheduler - Get Single Run Details

> WithZero Scheduler - Get Single Run Details is a paid API for AI agents from agents.withzero.xyz, paid per call via MPP, price unknown, status healthy (last checked 2026-09-14, last successful call 2026-09-04).

Retrieves detailed information about a single scheduled task run, including truncated stdout/stderr output, a logs URL for full logs, artifacts, cost breakdown, and execution metadata.

## Facts

- Endpoint: GET https://agents.withzero.xyz/api/v1/scheduler/runs/{id}
- Price: price unknown
- Payment: MPP
- Status: healthy
- Last checked: 2026-09-14
- Last successful call: 2026-09-04
- Success rate: 50% of calls made through Zero
- Activations on Zero: 2
- Provider: agents.withzero.xyz
- Website: https://agents.withzero.xyz
- Canonical page: https://www.zero.xyz/c/agents-withzero-xyz-withzero-scheduler-get-single-run-details-b89c7633
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_emjfDLj6H8KP9k9PGeGDt

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-get-single-run-details-b89c7633
```

Example prompt: Can you pull up the details for run ID 3f6a1b2c-4d5e-6789-abcd-ef0123456789 — I want to see its status, exit code, any stdout/stderr output, and a link to the full logs?

## When to prefer this

Use this endpoint when you need detailed execution metadata for a specific run by its UUID — including cost breakdown, artifacts, and a link to full logs. Prefer this over a run-list endpoint when you already have the run ID and need deep diagnostic information rather than a paginated summary.

## Known failure modes

- Run ID not found or does not belong to caller — 404 or 403 response
- Invalid UUID format for id parameter — 400 validation error
- Run not yet started — timestamps and exit_code may be null
- stdout/stderr truncated — full output only available via logs_url
- Payment or authentication failure — 402 or 401 response

## How this service works

Deep-dive single run with truncated stdout/stderr + logs_url. 📖 Full guide: https://scheduler.withzero.xyz/llms.txt

## Output

Returns a JSON object with the run's UUID, associated task ID, status string, trigger source, timestamps (started_at, finished_at, claimed_at, heartbeat_at), exit code, truncated stdout and stderr strings, a logs_url pointing to full log output, an array of durable artifacts (each with name, URL, path, bytes, content_type, created_at), cost figures in micros (daytona, overhead, siblings, total), the Daytona sandbox ID, and a count of sibling API calls made during the run.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "id"
 ],
 "properties": {
  "id": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "id",
  "task_id",
  "status",
  "trigger",
  "started_at",
  "finished_at",
  "claimed_at",
  "heartbeat_at",
  "exit_code",
  "stdout",
  "stderr",
  "cost_daytona_micros",
  "cost_overhead_micros",
  "cost_siblings_micros",
  "cost_total_micros",
  "sibling_call_count",
  "daytona_sandbox_id",
  "logs_url",
  "artifacts"
 ],
 "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"
  },
  "stderr": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "stdout": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "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)$"
  },
  "trigger": {
   "type": "string"
  },
  "logs_url": {
   "type": "string"
  },
  "artifacts": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "name",
     "url",
     "path",
     "bytes",
     "content_type",
     "created_at"
    ],
    "properties": {
     "url": {
      "type": "string"
     },
     "name": {
      "type": "string"
     },
     "path": {
      "type": "string"
     },
     "bytes": {
      "type": "number"
     },
     "created_at": {
      "type": "string"
     },
     "content_type": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     }
    },
    "additionalProperties": false
   },
   "description": "Durable artifacts stored by the run via the cdn capability. Fetchable by URL."
  },
  "exit_code": {
   "anyOf": [
    {
     "type": "number"
    },
    {
     "type": "null"
    }
   ]
  },
  "claimed_at": {
   "type": "string"
  },
  "started_at": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "finished_at": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "heartbeat_at": {
   "type": "string"
  },
  "cost_total_micros": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-withzero-xyz-withzero-scheduler-get-single-run-details-b89c7633/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)