Skip to main content
POST
Create cron job

Authorizations

Authorization
string
header
required

Session access JWT or an API token (insta_<prefix>_<secret>).

Path Parameters

projectId
string<uuid>
required

Body

application/json
name
string
required

unique per branch

Required string length: 1 - 64
expression
string
required

5-field cron expression, always evaluated in UTC

Required string length: 1 - 256
target
object
required

Where the job sends its request. An internal target names the SERVICE, never a URL: the worker resolves the live route at send time, so a redeploy or a region move cannot leave a job firing at a dead host.

branch
string

target branch (default: the project’s default branch)

request
object

Stored encrypted; its VALUES are never returned. Send the whole object to replace it — reads answer with request (method and header names only).

requestTimeoutMs
integer

excludes cold start: the wake is timed separately

Required range: 1000 <= x <= 300000
retry
object

Response

Default Response

job
object
required

A cron schedule. Header values are write-only; request describes the stored request without them.