---
title: "List schedules"
method: GET
path: "/api/schedules"
tags: ["Schedules"]
---

# List schedules

`GET /api/schedules`

Returns schedules with the full `taskTemplate` replaced by a short `taskTemplatePreview` by default — list views never render the full template. Pass `fields=full` to restore `taskTemplate`. Fetch the full template via `GET /api/schedules/{id}`.

## Query parameters

- `enabled` 'true' | 'false'
- `name` string
- `scheduleType` 'recurring' | 'one_time'
- `targetType` 'agent-task' | 'workflow' | 'script'
- `workflowId` string, uuid
- `scriptName` string
- `hideCompleted` 'true' | 'false'
- `consecutiveErrorsMin` integer, nullable
- `lastRunStatus` 'failed' | 'succeeded'
- `fields` 'full' | 'slim'
- `key` string — Non-unique asset directory namespace (for example shared/ or personal/<user-id>/drafts/). Runtime write boundaries normalize and validate the canonical form.
- `keyPrefix` string — Non-unique asset directory namespace (for example shared/ or personal/<user-id>/drafts/). Runtime write boundaries normalize and validate the canonical form.

## Response `200`

List of schedules

- object
  - `schedules` union, required
    - object[]
      - `id` string, uuid, required
      - `key` string, required — Non-unique asset directory namespace (for example shared/ or personal/<user-id>/drafts/). Runtime write boundaries normalize and validate the canonical form.
      - `name` string, required
      - `description` string
      - `cronExpression` string
      - `intervalMs` integer
      - `taskType` string
      - `tags` string[]
      - `priority` integer
      - `targetAgentId` string
      - `enabled` boolean
      - `lastRunAt` string, date-time
      - `nextRunAt` string, date-time
      - `createdByAgentId` string
      - `timezone` string
      - `consecutiveErrors` integer
      - `lastErrorAt` string, date-time
      - `lastErrorMessage` string
      - `model` string
      - `modelTier` 'smol' | 'regular' | 'smart' | 'ultra'
      - `scheduleType` 'recurring' | 'one_time'
      - `targetType` 'agent-task' | 'workflow' | 'script'
      - `workflowId` string, uuid
      - `scriptName` string
      - `scriptArgs` object
      - `createdAt` string, date-time, required
      - `lastUpdatedAt` string, date-time, required
      - `createdBy` string
      - `updatedBy` string
      - `favorite` boolean, required
      - `taskTemplatePreview` string, required
    - object[]
      - `id` string, uuid, required
      - `key` string, required — Non-unique asset directory namespace (for example shared/ or personal/<user-id>/drafts/). Runtime write boundaries normalize and validate the canonical form.
      - `name` string, required
      - `description` string
      - `cronExpression` string
      - `intervalMs` integer
      - `taskTemplate` string
      - `taskType` string
      - `tags` string[]
      - `priority` integer
      - `targetAgentId` string
      - `enabled` boolean
      - `lastRunAt` string, date-time
      - `nextRunAt` string, date-time
      - `createdByAgentId` string
      - `timezone` string
      - `consecutiveErrors` integer
      - `lastErrorAt` string, date-time
      - `lastErrorMessage` string
      - `model` string
      - `modelTier` 'smol' | 'regular' | 'smart' | 'ultra'
      - `scheduleType` 'recurring' | 'one_time'
      - `targetType` 'agent-task' | 'workflow' | 'script'
      - `workflowId` string, uuid
      - `scriptName` string
      - `scriptArgs` object
      - `createdAt` string, date-time, required
      - `lastUpdatedAt` string, date-time, required
      - `createdBy` string
      - `updatedBy` string
      - `favorite` boolean, required
  - `count` integer, required

---

[API](https://skmtc.net/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.net/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/desplega-ai/agent-swarm-api/versions/101e7a060651/schema)