---
title: "Delete Sandbox Schedule"
method: DELETE
path: "/sandboxes/{sandboxName}/schedules/{scheduleId}"
tags: ["compute"]
---

# Delete Sandbox Schedule

`DELETE /sandboxes/{sandboxName}/schedules/{scheduleId}`

Deletes a Sandbox Schedule by id.

## Response `200`

successful operation

- SandboxScheduleEntry — A scheduled task that executes a process inside the sandbox at specified times. Stored in the dedicated schedules table (no longer embedded in the sandbox spec).
  - `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').

---

[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)