curl -X POST "https://api.ionq.co/v0.3/jobs" \
-H "Authorization: apiKey your-api-key" \
-H "Content-Type: application/json" \
-d '{ "input": { "format": "ionq.circuit.v0", "qubits": 1, "circuit": [ {"gate": "h", "target": 0} ] } }'{
"id": "aa54e783-0a9b-4f73-ad2f-63983b6aa4a8",
"status": "ready"
}Create a Job
To submit a program to be simulated or executed on our quantum hardware, POST it to the jobs endpoint.
For ionq.circuit.v0 multi-circuit payloads, each entry in input.circuits inherits the parent gateset unless the circuit provides its own override.
curl -X POST "https://api.ionq.co/v0.3/jobs" \
-H "Authorization: apiKey your-api-key" \
-H "Content-Type: application/json" \
-d '{ "input": { "format": "ionq.circuit.v0", "qubits": 1, "circuit": [ {"gate": "h", "target": 0} ] } }'{
"id": "aa54e783-0a9b-4f73-ad2f-63983b6aa4a8",
"status": "ready"
}Body
A job to be created
A job name.
"My Awesome Job"
User defined metadata.
{
"custom_key": "a string, maximum 400 chars"
}
How many times to execute your circuit when submitting to a QPU or a "non-ideal" noisy simulator.
Target hardware for job to run on.
qpu.harmony, qpu.aria-1, qpu.aria-2, qpu.forte-1, qpu.forte-enterprise-1, simulator When the target is "simulator", this field specifies optional noise parameters for simulation. (If these noise parameters are not provided, simulations will run on an ideal quantum computer model, without noise.) This field does not apply to qpu.* targets. When a noise model is applied, the simulator qubit limit is inherited from the modeled QPU's qubit limit. (This limit does not apply to the ideal quantum computer simulator. Please refer to the current qubit limit of the ideal quantum computer simulator.)
Show child attributes
Show child attributes
Input for creating a job via a Quantum Program
- JobInput
- JobInput
- JobInput
- JobInput
- JobInput
Show child attributes
Show child attributes
Which error mitigation methods to apply to this circuit. This may affect how the job is compiled, and what configuration can be used to fetch results.
Show child attributes
Show child attributes
Response
Successfully created a Job
Response body from a successful job creation.
The UUID of a job. We'll provide the UUID initially in our response to a job creation request.
"aa54e783-0a9b-4f73-ad2f-63983b6aa4a8"
Status of a job (always ready).
ready Was this page helpful?