POST
Create a cron job

Authorizations

Authorization
string
header
required

Bearer token for authentication. Format: 'Bearer {token}'

Headers

X-Workspace-Id
string

Workspace ID (uses default workspace if not provided)

Path Parameters

uuid
string
required

Application UUID

Body

application/json

Create a cron job

name
string
required

Unique cron job identifier

label
string

Human-readable display name for the cron job

schedule_type
enum<string>

Schedule type: 'cron' for custom cron expression, 'interval' for predefined intervals

Available options:
cron,
interval
interval_type
enum<string>

Predefined interval: 'every_10_minutes', 'hourly', or 'daily'. Only for interval schedule type.

Available options:
every_10_minutes,
hourly,
daily
cron
string

Cron expression (e.g., '0 * * * *' for hourly). Only for cron schedule type.

command
string

Shell command to execute (e.g., 'rake db:cleanup', 'python script.py')

daily_time
string

Execution time for daily jobs in HH:MM format (24-hour). Only for daily interval.

minute
string

Minute component for scheduling (0-59)

hour
string

Hour component for scheduling (0-23)

Response

Create a cron job

Api_V1_Entities_Cronjob model

uuid
string
required

Cron job UUID

name
string
required

Cron job name

label
string
required

Human-readable display name

schedule_type
string
required

Schedule type (cron, interval)

interval_type
string
required

Interval type (every_10_minutes, hourly, daily)

hour
string
required

Hour component

minute
string
required

Minute component

cron_expression
string
required

Cron expression for custom schedules

command
string
required

Command to execute

status
string
required

Current status (running, stopped)

last_job_name
string
required

Name of the most recent run

last_job_status
string
required

Status of the most recent run (e.g. running, complete, failed)

last_job_run_at
string<date-time>
required

Last execution timestamp

created_at
string<date-time>
required

Creation timestamp

updated_at
string<date-time>
required

Last update timestamp