---
title: "Create job execution"
method: POST
path: "/jobs/{jobId}/executions"
tags: ["jobs"]
---

# Create job execution

`POST /jobs/{jobId}/executions`

## Request

- Base URL: `https://api.blaxel.ai/v0`
- URL: `https://api.blaxel.ai/v0/jobs/{jobId}/executions`
- Auth: one of:
  - OAuth 2
    - Authorization code: `/oauth/authorize`
    - Client credentials
    - Token URL: `/oauth/token` scopes: `jobs:create`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/blaxel/apis/blaxel-control-plane/docs/jobs/:jobId/executions/post.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Path parameters

- `jobId` string, required

## Request body

- CreateJobExecutionRequest: Request to create a job execution
  - `env` object: Environment variable overrides (optional, will merge with job's environment variables)
  - `executionId` string: Execution ID (optional, will be generated if not provided)
  - `id` string: Unique message ID
  - `jobId` string: Job ID
  - `memory` integer: Memory override in megabytes (optional, must be lower than or equal to job's configured memory)
  - `tasks` object[]: Array of task parameters for parallel execution
  - `workspaceId` string: Workspace ID

## Response `200`

successful operation

- CreateJobExecutionOutput: Response returned when a job execution is successfully created. Contains identifiers and the tasks that will be executed.
  - `executionId` string: Unique identifier for the created execution. Use this ID to track execution status, retrieve logs, or cancel the execution.
  - `id` string: Unique identifier for this request, used for idempotency and tracking. Auto-generated if not provided in the request.
  - `jobId` string: Name of the job that this execution belongs to
  - `tasks` object[]: Array of task configurations that will be executed in parallel according to the job's concurrency settings. Each task can have custom parameters.
  - `workspaceId` string: Name of the workspace where the job execution was created

## Other responses

- `400`: bad request
- `500`: internal server error

---

[API](https://skmtc.dev/blaxel/apis/blaxel-control-plane.md) - [All operations](https://skmtc.dev/blaxel/apis/blaxel-control-plane/llms.txt) - [OpenAPI document](https://skmtc.dev/blaxel/apis/blaxel-control-plane/revisions/dfa264bc72ee?raw)