Soft-delete several jobs by QRN. Non-terminal jobs keep running and are still billed (see stillRunning).

DELETE/jobs

Authorizations

X-API-KEYstringheaderrequired

Authenticate requests using an API key linked to your qBraid account. Obtain your key by registering or logging in at account.qbraid.com.

Query Parameters

qrnsstringrequired

JSON array of job QRNs to delete (e.g., ["qbraid:job:abc123", "qbraid:job:xyz789"])

Response

200Success.
successbooleanrequired
dataobjectrequired
400Validation error.
Soft-delete multiple jobs
curl --request DELETE \
  --url 'https://api-v2.qbraid.com/api/v1/jobs?qrns=<qrns>' \
  --header 'X-API-KEY: <api-key>'
import requests

url = "https://api-v2.qbraid.com/api/v1/jobs?qrns=<qrns>"
headers = {
    "X-API-KEY": "<api-key>"
}

response = requests.delete(url, headers=headers)
print(response.json())
const url = "https://api-v2.qbraid.com/api/v1/jobs?qrns=<qrns>";
const options = {
  method: "DELETE",
  headers: {"X-API-KEY":"<api-key>"},
};

const response = await fetch(url, options);
console.log(await response.json());
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-v2.qbraid.com/api/v1/jobs?qrns=<qrns>",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	url := "https://api-v2.qbraid.com/api/v1/jobs?qrns=<qrns>"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))
}
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api-v2.qbraid.com/api/v1/jobs?qrns=<qrns>"))
    .header("X-API-KEY", "<api-key>")
    .method("DELETE", HttpRequest.BodyPublishers.noBody())
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
require 'uri'
require 'net/http'

url = URI("https://api-v2.qbraid.com/api/v1/jobs?qrns=<qrns>")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body
{
  "success": true,
  "data": {
    "successfulIds": [
      "<string>"
    ],
    "failedIds": {},
    "stillRunning": [
      "<string>"
    ]
  }
}
{
  "success": false,
  "message": "<string>",
  "error": {
    "message": "<string>",
    "code": "<string>"
  }
}