> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blobhub.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Schedules

List schedules in the scheduler blob revision. Results are sorted by creation time (newest first) and paginated in batches of 10.

## **POST** `/revisions/:id/data/query` (Command: `list_schedules`)

### Request Body

| Parameter           | Type   | Required | Description                                                            |
| :------------------ | :----- | :------- | :--------------------------------------------------------------------- |
| `engine`            | string | Yes      | Must be `scheduler_blobhub`.                                           |
| `command`           | string | Yes      | Must be `list_schedules`.                                              |
| `start_schedule_id` | string | No       | Pagination cursor. Pass the `last_schedule_id` from the previous page. |

### Response

| Parameter          | Type          | Description                                                                |
| :----------------- | :------------ | :------------------------------------------------------------------------- |
| `schedules`        | array         | Schedule objects in descending `created_at` order (up to 10 per page).     |
| `last_schedule_id` | string / null | Pagination cursor for the next page, or `null` if there are no more pages. |

### Example

<CodeGroup>
  ```json Request theme={null}
  {
    "engine": "scheduler_blobhub",
    "command": "list_schedules"
  }
  ```

  ```json Response theme={null}
  {
    "schedules": [
      {
        "id": "sched-002",
        "revision_id": "rev-scheduler-001",
        "created_at": "2026-04-07T12:05:00Z",
        "modified_at": "2026-04-07T12:05:00Z",
        "auth_target": "user",
        "auth_target_id": "user-001",
        "enabled": true,
        "repeat": "one_time",
        "cron_expression": null,
        "invocation_time": "2026-05-01T14:30:00",
        "timezone": "UTC",
        "start_date": null,
        "end_date": null,
        "state": "active",
        "invocation_target_type": "workflow",
        "invocation_target": {
          "org_id": "org-123",
          "blob_id": "blob-456",
          "revision_id": "rev-789",
          "session_id": "sess-abc",
          "workflow_alias": "one-shot-job",
          "input_data": ["payload"]
        }
      },
      {
        "id": "sched-001",
        "revision_id": "rev-scheduler-001",
        "created_at": "2026-04-07T12:00:00Z",
        "modified_at": "2026-04-07T12:00:00Z",
        "auth_target": "user",
        "auth_target_id": "user-001",
        "enabled": true,
        "repeat": "recurring_cron",
        "cron_expression": "0 9 * * ? *",
        "invocation_time": null,
        "timezone": "America/New_York",
        "start_date": null,
        "end_date": null,
        "state": "active",
        "invocation_target_type": "workflow",
        "invocation_target": {
          "org_id": "org-123",
          "blob_id": "blob-456",
          "revision_id": "rev-789",
          "session_id": "sess-abc",
          "workflow_alias": "daily-report",
          "input_data": []
        }
      }
    ],
    "last_schedule_id": null
  }
  ```
</CodeGroup>