Skip to main content
POST
Create a scheduled run

Authorizations

Authorization
string
header
required

API key ret_live_… created in Settings → API keys.

Body

application/json
workspace_id
string
required
title
string
required
prompt
string
required

The full mission each execution receives. Nobody answers during an execution.

cadence
object
required
timezone
string
required

IANA time zone, for example Europe/Paris.

Response

The draft.

id
string
required
workspace_id
string
required
title
string
required
summary
string | null
required

Short description written when the app's agent created it.

prompt
string
required
cadence
object
required
timezone
string
required
status
enum<string>
required

archived means deleted.

Available options:
draft,
active,
paused,
archived
next_run_at
string<date-time> | null
required

Set only while active.

created_at
string<date-time>
required
updated_at
string<date-time>
required