Create Job Execution

Create execution and job_executions records for a scheduled job.

This endpoint is used by workers to create execution records when jobs are triggered. It creates both:

1. An execution record in the executions table
2. A job_executions junction record linking the job to the execution

Available at both /job-executions and /create for backwards compatibility.

POST /api/v1/executions/job-executions

Create Job Execution

cURL

curl --request POST \
  --url https://control-plane.kubiya.ai/api/v1/executions/job-executions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "execution_id": "<string>",
  "entity_type": "<string>",
  "prompt": "<string>",
  "trigger_type": "<string>",
  "job_id": "<string>",
  "entity_id": "<string>",
  "trigger_metadata": {}
}
'

422

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

Authorization · string · header · required

Enter your Kubiya API token (format: Bearer )

Body

application/json

Request to create a job execution record

execution_id · string · required

entity_type · string · required

prompt · string · required

trigger_type · string · required

job_id · string | null

entity_id · string | null

trigger_metadata · Trigger Metadata · object

Response

201

application/json

Successful Response