---
title: "Scheduled tasks of one workspace"
method: GET
path: "/v1/admin/tenants/{tenant_id}/cron-jobs"
tags: ["admin"]
---

# Scheduled tasks of one workspace

`GET /v1/admin/tenants/{tenant_id}/cron-jobs`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/admin/tenants/{tenant_id}/cron-jobs`
- Auth: HTTP bearer

The live scheduled tasks of one workspace, soonest next run first, with tasks that have no next run last. Pass `actor_id` to list only the tasks one member owns. Each task has its name, kind, whether it is switched on, its schedule and time zone or its one-time run time, its next and last run, its run count, its owner, where it delivers, and its prompt and instructions with secrets removed. A finished one-time task is not listed. The read is recorded against your staff account.

## Path parameters

- `tenant_id` string, uuid, required: The workspace id.

## Query parameters

- `actor_id` string, uuid, nullable: Only tasks this member owns. The member's actor id, from the workspace member list.
- `limit` integer: How many tasks to return, 1 to 100. Defaults to 25.
- `offset` integer: How many tasks to skip.

## Response `200`

Successful Response

- CronJobs
  - `items` CronJobItem[], required
    - `id` string, uuid, required
    - `name` string, required
    - `kind_code` string, required
    - `enabled` boolean, required
    - `schedule` string, nullable, required
    - `timezone` string, nullable, required
    - `run_at` string, date-time, nullable, required
    - `next_run_at` string, date-time, nullable, required
    - `last_run_at` string, date-time, nullable, required
    - `run_count` integer, required
    - `owner` AdminActorRef, required
      - `id` string, uuid, required
      - `display_name` string, required
      - `unavailable` boolean
    - `delivery` CronJobDelivery, required
      - `platform_code` string, nullable, required
      - `kind_code` string, nullable, required
      - `title` string, nullable, required
    - `prompt` string, nullable, required
    - `instructions` string, nullable, required
  - `total` integer, required

## Other responses

- `422`: Validation Error

---

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