v1

latestOpenAPI 3.0.32026-07-22194221292.5 KB

jobs

Create job execution

Triggers a new execution of the batch job. Each execution runs multiple tasks in parallel according to the job's configured concurrency. Tasks can be parameterized via the request body.

post/jobs/{jobId}/executions

Path parameters

jobIdstring required

Name of the job

Request body

envobject

Environment variable overrides (optional, will merge with job's environment variables)

executionIdstring

Execution ID (optional, will be generated if not provided)

idstring

Unique message ID

jobIdstring

Job ID

memoryinteger

Memory override in megabytes (optional, must be lower than or equal to job's configured memory)

tasksobject[]

Array of task parameters for parallel execution

workspaceIdstring

Workspace ID

Example request

{
  "jobId": "data-processing-job",
  "memory": 2048
}

Response

successful operation

executionIdstring

Unique identifier for the created execution. Use this ID to track execution status, retrieve logs, or cancel the execution.

idstring

Unique identifier for this request, used for idempotency and tracking. Auto-generated if not provided in the request.

jobIdstring

Name of the job that this execution belongs to

tasksobject[]

Array of task configurations that will be executed in parallel according to the job's concurrency settings. Each task can have custom parameters.

workspaceIdstring

Name of the workspace where the job execution was created

Example response

{
  "executionId": "exec-abc123",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "jobId": "data-processing-job",
  "workspaceId": "my-workspace"
}