Create a job (ordered pipeline of steps, cron and/or on demand)
const url = 'https://example.com/projects/example/jobs';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"concurrencyPolicy":"forbid","description":"example","enabled":true,"name":"example","runTimeoutSeconds":1,"scheduleCron":"example","steps":[{"command":"example","cpuRequestMilli":1,"deploymentId":"example","envVars":[{"key":"example","value":"example"}],"image":"example","memoryRequestBytes":"example","name":"example","retries":1,"script":"example","scriptRuntime":"bash","timeoutSeconds":1,"type":"script"}],"timeZone":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/projects/example/jobs \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "concurrencyPolicy": "forbid", "description": "example", "enabled": true, "name": "example", "runTimeoutSeconds": 1, "scheduleCron": "example", "steps": [ { "command": "example", "cpuRequestMilli": 1, "deploymentId": "example", "envVars": [ { "key": "example", "value": "example" } ], "image": "example", "memoryRequestBytes": "example", "name": "example", "retries": 1, "script": "example", "scriptRuntime": "bash", "timeoutSeconds": 1, "type": "script" } ], "timeZone": "example" }'Auth: authenticated
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Request Body
Section titled “Request Body”object
Forbid (default) skips a scheduled fire while a run is active; allow runs them in parallel
False creates the job with a paused schedule
Job name, unique within the project
Whole-run timeout in seconds (default 21600)
5-field cron schedule (UTC unless timeZone is set); omit for manual-only
Ordered pipeline steps
object
Shell command; required for app steps, optional for image steps (defaults to the image entrypoint)
CPU request in millicores
Deployment UUID (app type, must belong to the same project)
Environment variables (for app steps these override the deployment env)
object
Container image reference (image type)
Step display name
Retries on failure (default 0)
Script source (script type)
Script runtime (script type)
Per-step timeout (default 1800)
Script = inline script in a curated runtime; app = command in an existing deployment’s image+env; image = arbitrary container image
IANA time zone for the cron schedule (default UTC)
Responses
Section titled “Responses”OK
object
object
Present on detail responses, absent on list responses
object
object
object
object
Example
{ "concurrencyPolicy": "forbid", "lastRun": { "status": "pending", "trigger": "manual" }, "recentRuns": [ { "status": "pending" } ], "steps": [ { "scriptRuntime": "bash", "type": "script" } ], "stepSummaries": [ { "type": "script" } ]}