---
title: "Create Job"
method: POST
path: "/jobs"
tags: ["jobs"]
---

# Create Job

`POST /jobs`

Submit a quantum job to the specified device.

**Request Body:**
- **program** (object, required): Quantum program with format and data fields
- **shots** (integer, required): Number of shots to execute
- **deviceQrn** (string, required): Device QRN (qBraid Resource Name)
- **runtimeOptions** (object, optional): Runtime options
- **tags** (object, optional): Job tags
- **name** (string, optional): Job name

**Headers:**
- **X-API-KEY** (string, required): Your qBraid API key

**Returns:**
- Object containing the new job QRN and initial status

**Raises:**
- **422**: Validation error if required fields are missing or invalid

## Request body

- JobRequest — Schema for job submission request body
  - `name` string, nullable — Job name
  - `shots` integer, required — Number of shots to execute
  - `deviceQrn` string, required — qBraid device resource name
  - `tags` object — Job tags
  - `runtimeOptions` object — Runtime options
  - `program` Program, required — Schema for quantum program
    - `format` 'qasm2' | 'qasm3' | 'qir.bc' | 'qir.ll' | 'analog' | 'pulser.sequence' | 'quil' | 'ionq.circuit.v0' | 'problem', required — Program format
    - `data` unknown, required

## Response `201`

Successful Response

- CreateJobResponse — Response schema for job creation
  - `success` boolean, required — Whether the job was created successfully
  - `data` object, required
    - `jobQrn` string, required — QRN of the newly created job
    - `status` string, required — Initial job status

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/qbraid/apis/qbraid-runtime-api.md) · [All operations](https://skmtc.net/qbraid/apis/qbraid-runtime-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qbraid/qbraid-runtime-api/versions/6e818ad19cde/schema)