---
title: "List scheduled agents (cursor-paginated; filters workspaceId/enabled)"
method: GET
path: "/scheduled-agents"
tags: ["Scheduled agents"]
---

# List scheduled agents (cursor-paginated; filters workspaceId/enabled)

`GET /scheduled-agents`

## Query parameters

- `cursor` string
- `limit` integer
- `workspaceId` string, uuid
- `enabled` boolean

## Response `200`

A page of scheduled agents (list envelope + `total`).

- object — The canonical v2 list envelope. Every list endpoint returns this shape; per-endpoint `items` element types (and documented extras like `total`) are declared on each operation.
  - `object` 'list', required
  - `items` ScheduledAgent[], required — The page of objects. Element type is per-endpoint.
    - `object` 'scheduled_agent', required
    - `id` string, uuid, required
    - `workspaceId` string, uuid, required
    - `slug` string, required
    - `name` string, required
    - `description` string, nullable, required
    - `prompt` string, required
    - `cron` string, required
    - `model` string, nullable, required
    - `enabled` boolean, required
    - `planBlocked` boolean, required — True when the org cannot currently run scheduled tasks (gated at dispatch).
    - `nextRunAt` string, date-time, nullable, required
    - `lastRunAt` string, date-time, nullable, required
    - `url` string, uri, required
    - `handoff` object — Present when planBlocked — points the caller at the upgrade flow.
  - `nextCursor` string, nullable, required — Cursor for the next page; `null` means this is the last page.
  - `url` string, required — The path this list was fetched from (query string excluded).
  - `total` integer, required — Total scheduled agents in the listing's scope (all pages).

---

[API](https://skmtc.net/origami/apis/origami-agent-api.md) · [All operations](https://skmtc.net/origami/apis/origami-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/origami/origami-agent-api/versions/8083ad7fe081/schema)