Create Sandbox Schedule - Documentation

curl --request POST \ --url https://api.blaxel.ai/v0/sandboxes/{sandboxName}/schedules \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "id": "schedule-0", "input": { "command": "python train.py --epochs 10", "env": {}, "keepAlive": true, "name": "training-job", "timeout": 3600, "workingDir": "/app" }, "maxExecutions": 100, "type": "cron", "value": "0 8 * * 1-5" } '

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

Authorizations

Authorization

string

header

required

OAuth2 authentication with JWT tokens

Path Parameters

sandboxName

string

required

Name of the Sandbox

Body

application/json

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

string

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

Example:

"schedule-0"

input

object

Process execution configuration for a scheduled sandbox task

Show child attributes

maxExecutions

integer

Maximum number of execution records kept for this schedule. Once reached, recording a new execution deletes the oldest. Defaults to 100.

Example:

100

type

enum<string>

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

Available options:

cron,

at,

sleep

Example:

"cron"

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

Example:

"0 8 * * 1-5"

Response

200 - application/json

successful operation

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

read-only

Creation timestamp (read-only).

string

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

Example:

"schedule-0"

input

object

Process execution configuration for a scheduled sandbox task

Show child attributes

maxExecutions

integer

Maximum number of execution records kept for this schedule. Once reached, recording a new execution deletes the oldest. Defaults to 100.

Example:

100

type

enum<string>

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

Available options:

cron,

at,

sleep

Example:

"cron"

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

Example:

"0 8 * * 1-5"