v1

latestOpenAPI 3.1.02026-07-26102230.9 KB
jobs

Create Job

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
post/jobs

Request body

namestring nullable

Job name

shotsinteger required

Number of shots to execute

deviceQrnstring required

qBraid device resource name

tagsobject

Job tags

runtimeOptionsobject

Runtime options

Response

Successful Response

successboolean required

Whether the job was created successfully

Example response

{
  "data": {
    "jobQrn": "aws:aws:sim:dm1-a1b2-qjob-1234567890abcdef",
    "status": "INITIALIZING"
  }
}