# GET /api/v1 — Scheduler Agent Catalog

> GET /api/v1 — Scheduler Agent Catalog is a paid API for AI agents from scheduler.withzero.xyz, paid per call via MPP, price unknown, status healthy (last checked 2026-09-14, last successful call 2026-09-01).

Returns the full scheduler agent catalog including getting started guides, key concepts, sandbox contract details, lifecycle routes, error codes, and discovery URLs

## Facts

- Endpoint: GET https://scheduler.withzero.xyz/api/v1
- Price: price unknown
- Payment: MPP
- Status: healthy
- Last checked: 2026-09-14
- Last successful call: 2026-09-01
- Success rate: 100% of calls made through Zero
- Activations on Zero: 14
- Provider: scheduler.withzero.xyz
- Website: https://scheduler.withzero.xyz
- Canonical page: https://www.zero.xyz/c/scheduler-withzero-xyz-get-api-v1-scheduler-agent-catalog-3fe13068
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0CNsf5qJvk8_K_tOgOYIs

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-get-api-v1-scheduler-agent-catalog-3fe13068
```

Example prompt: Show me the full scheduler agent catalog for scheduler.withzero.xyz — I want to understand how to get started, what the sandbox call/generate_text/store_artifact contracts look like, and what error codes and discovery URLs are available.

## When to prefer this

Use this endpoint when an AI agent or developer needs to orient itself to the scheduler.withzero.xyz API — discovering available routes, understanding sandbox contracts, learning error codes, or bootstrapping integration before creating or managing cron tasks.

## Known failure modes

- Service unavailable (5xx) if the scheduler backend is down
- Unexpected empty response if the catalog has not been populated
- Network timeout if the endpoint is slow to respond

## How this service works

Agent catalog: getting_started + key_concepts + the full `sandbox` section documenting the call()/generate_text/store_artifact contract with worked examples + the sibling/marketplace gating. Start here. 📖 Full guide: https://scheduler.withzero.xyz/llms.txt

## Output

Returns a JSON object containing: getting_started section (minimal and full_walkthrough), key_concepts, sandbox section (call()/generate_text/store_artifact contract with signatures and return shapes, discover-then-cap flow for paid marketplace capabilities, worked examples), lifecycle route map, error_codes, and discovery_urls.

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {},
 "description": "The full scheduler agent catalog: `getting_started` (minimal + full_walkthrough), `key_concepts`, the `sandbox` section (the call()/generate_text/store_artifact contract with signatures, return shapes, the discover-then-cap flow for paid marketplace capabilities, and worked examples), the `lifecycle` route map, `error_codes`, and `discovery_urls`.",
 "additionalProperties": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/scheduler-withzero-xyz-get-api-v1-scheduler-agent-catalog-3fe13068/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)