Create and start a new job on a branch.
Create and start a new job on a branch. After creation, auto-fetch the full job object.
This skill ONLY handles: Creating and starting a new job on a branch.
For uploading job input files first → use job-input-upload
For monitoring after creation → use get-job-progress or get-job-logs
Note: NovaDB object IDs start at 2²¹ (2,097,152). All IDs in examples below are samples — always use real IDs from your system.
novadb_cms_create_job — Create the jobnovadb_cms_get_job — Fetch the created job (required follow-up){
"branchId": 2100347,
"jobDefinitionId": 12345,
"scopeIds": [100, 200],
"objIds": [300, 400],
"parameters": [{ "name": "param1", "values": ["value1"] }],
"inputFile": { "token": "upload-token", "name": "input.csv" },
"language": 201,
"username": "jdoe"
}
branchId — Branch ID (number, required)jobDefinitionId — Job definition ID (number, required)scopeIds — Scope object IDs (optional)objIds — Object IDs to process (optional)parameters — Job parameters as name/values pairs (optional)inputFile — Input file reference from prior upload via novadb_cms_job_input_upload (optional)language — Language ID for the job (optional)username — Acting username for audit (optional)novadb_cms_create_job with the parameters above{ id } — not the full job objectnovadb_cms_get_job with the returned id to fetch the full jobThe create call returns { id }. After fetching, the full job includes id, state, definition, branch, progress, timestamps, etc.
Returns job creation result. Use get-job to fetch the full job object with state and progress.
0=New, 1=Running, 2=Succeeded, 3=Error, 4=KillRequested, 5=RestartRequested.