BLblaxel
compute

Create Sandbox Schedule

Adds a schedule to a Sandbox.

post/sandboxes/{sandboxName}/schedules

Request

Request body

createdAtstring

Creation timestamp (read-only).

idstring

Unique identifier for this schedule within its sandbox. Auto-generated if not provided.

maxExecutionsinteger

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

valuestring

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').

Example request

{
  "id": "schedule-0",
  "input": {
    "command": "python train.py --epochs 10",
    "keepAlive": true,
    "name": "training-job",
    "timeout": 3600,
    "workingDir": "/app"
  },
  "maxExecutions": 100,
  "type": "cron",
  "value": "0 8 * * 1-5"
}

Response

successful operation

createdAtstring

Creation timestamp (read-only).

idstring

Unique identifier for this schedule within its sandbox. Auto-generated if not provided.

maxExecutionsinteger

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

valuestring

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').

Example response

{
  "id": "schedule-0",
  "input": {
    "command": "python train.py --epochs 10",
    "keepAlive": true,
    "name": "training-job",
    "timeout": 3600,
    "workingDir": "/app"
  },
  "maxExecutions": 100,
  "type": "cron",
  "value": "0 8 * * 1-5"
}

Changes

No recorded changes to this operation across all 1 revision of this API.