Skip to main content
POST
Run a schedule now

Authorizations

Authorization
string
header
required

A workspace API key (oc_…) or organization API key (oc_org_…). Workspace-scoped endpoints called with an organization key also need X-Workspace-Id.

Path Parameters

agentId
string
required
cronId
string
required

Response

The schedule, with nextFireAt pulled forward

id
string
agentId
string
name
string
prompt
string
schedule
string

A cron expression (five fields, croner syntax).

timezone
string

IANA time zone the schedule is evaluated in.

enabled
boolean
disabledReason
enum<string> | null

Why the platform paused it, when it did. completed marks a one-shot schedule that fired its last occurrence.

Available options:
authorization,
failures,
completed,
null
nextFireAt
string<date-time> | null
lastFiredAt
string<date-time> | null
lastOutcome
enum<string> | null
Available options:
ok,
failed,
skipped_busy,
null
consecutiveFailures
integer
createdAt
string<date-time>