---
title: "List scheduled tasks across the caller's projects"
method: GET
path: "/scheduled-tasks"
tags: ["scheduled-tasks"]
---

# List scheduled tasks across the caller's projects

`GET /scheduled-tasks`

## Request

- Base URL: `https://api.letsship.ai/v1`
- URL: `https://api.letsship.ai/v1/scheduled-tasks`
- Auth: none declared

Newest first. Give `projectId` to list the scheduled tasks of one project. A token for one project lists only the tasks of that project.

## Query parameters

- `projectId` string: Only the scheduled tasks of this project. A project that the caller cannot reach gives an empty list.

## Response `200`

Scheduled tasks

- ListScheduledTasksResponse
  - `data` ScheduledTask[], required
    - `createdByUserId` string, nullable
    - `id` string, required
    - `orgId` string, required
    - `projectId` string, required
    - `name` string, required
    - `prompt` string, required
    - `templateKey` string, nullable, required
    - `triggers` ScheduledTaskTrigger[], required
      - `kind` 'schedule', required
      - `schedule` ScheduledTaskSchedule, required
        - `interval` 'daily' | 'weekly' | 'monthly', required
        - `time` string, required
        - `timezone` string, required
        - `weekday` 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday'
        - `dayOfMonth` integer
    - `labels` string[], required
    - `skipIfPreviousOpen` boolean, required
    - `enabled` boolean, required
    - `nextRunAt` integer, nullable, required
    - `lastRunAt` integer, nullable, required
    - `createdAt` integer, required
    - `updatedAt` integer, required
  - `nextCursor` string, nullable, required

## Other responses

- `401`: Unauthenticated

---

[API](https://skmtc.dev/letsship/apis/ship-api.md) · [All operations](https://skmtc.dev/letsship/apis/ship-api/llms.txt) · [OpenAPI document](https://skmtc.dev/letsship/apis/ship-api/revisions/e6eac1bcadd4?raw)