---
title: "List Sandbox Schedules"
method: GET
path: "/sandboxes/{sandboxName}/schedules"
tags: ["compute"]
---

# List Sandbox Schedules

`GET /sandboxes/{sandboxName}/schedules`

Returns the schedules configured on a Sandbox. Starting with API version 2026-04-28 the response is wrapped in `{data, meta}` and supports cursor pagination via the `cursor` and `limit` query parameters; older versions return a bare array.

## Query parameters

- `limit` integer
- `cursor` string
- `sort` 'createdAt:desc' | 'createdAt:asc' | 'name:asc' | 'name:desc'
- `q` string
- `type` 'cron' | 'at'

## Response `200`

successful operation

- SandboxScheduleEntryList — Cursor-paginated list of a sandbox's schedule definitions.
  - `data` SandboxScheduleEntry[] — Page of schedule definitions.
    - `createdAt` string — Creation timestamp (read-only).
    - `id` string — Unique identifier for this schedule within its sandbox. Auto-generated if not provided.
    - `input` SandboxScheduleInput — Process execution configuration for a scheduled sandbox task
      - `command` string — Shell command to execute inside the sandbox
      - `env` object — Environment variables to set for the process. May contain secrets, so values are encrypted at rest and masked in API responses unless an admin requests show_secrets=true.
      - `keepAlive` boolean — Keep the sandbox alive (disable scale-to-zero) while the process runs. Defaults to true.
      - `name` string — Optional name for the process (used to retrieve status/logs)
      - `timeout` integer — Timeout in seconds for the process. Defaults to 600 (10 minutes). Set to 0 for no timeout.
      - `workingDir` string — Working directory for the command
    - `maxExecutions` integer — Maximum number of execution records kept for this schedule. Once reached, recording a new execution deletes the oldest. Defaults to 100.
    - `type` 'cron' | 'at' | 'sleep' — Type of schedule timing. 'cron' for recurring (5-field expression), 'at' for a specific RFC 3339 datetime, 'sleep' for a duration from now (resolved to 'at' on creation).
    - `value` string — Timing value. For 'cron': a 5-field cron expression (e.g. '0 8 * * 1-5'). For 'at': an RFC 3339 datetime (e.g. '2026-07-01T09:00:00Z'). For 'sleep': a duration (e.g. '2h', '30m', '7d').
  - `meta` PaginationMeta — Pagination metadata returned alongside a page of listing results. Always present on listing endpoints starting with API version 2026-04-28.
    - `hasMore` boolean — True when more pages are available beyond the current one.
    - `nextCursor` string — Opaque cursor to pass back as the `cursor` query param for the next page. Empty when there are no more pages.
    - `total` integer — Total number of items in the workspace, ignoring the current page's filters. Lets the UI render "page X of Y" without walking the cursor chain. Computed from the hash-only metadata.workspace GSI count, so search (`q`) does not narrow it.

---

[API](https://skmtc.net/blaxel/apis/blaxel-control-plane.md) · [All operations](https://skmtc.net/blaxel/apis/blaxel-control-plane/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blaxel/blaxel-control-plane/versions/dfa264bc72ee/schema)