---
title: "List scheduled tasks"
method: GET
path: "/api/scheduled-tasks"
tags: ["Stats"]
---

# List scheduled tasks

`GET /api/scheduled-tasks`

## Query parameters

- `enabled` 'true' | 'false'
- `name` string
- `scheduleType` 'recurring' | 'one_time'
- `hideCompleted` 'true' | 'false'
- `targetType` 'agent-task' | 'workflow' | 'script'
- `workflowId` string, uuid
- `scriptName` string

## Response `200`

Scheduled tasks list

- object
  - `scheduledTasks` object[], required
    - `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

---

[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/e2028c1ef6f5/schema)