Qubit Isolation Zones

The Isolation module provides logical partitioning of qubit registers across different security domains. In multi-tenant or classified environments, isolation zones enforce that circuits from different projects or classification levels never share physical qubits, prevent crosstalk leakage, and produce per-zone audit trails.

Use Cases

Multi-tenant QPU time-sharing: Ensure organisation A’s qubits are physically separate from organisation B’s
Classified research: Separate SECRET and UNCLASSIFIED workloads on the same QPU
Lab partitioning: Allocate dedicated qubit regions to different research groups
Compliance: Satisfy FIPS 140-3 and NIST SP 800-175B physical isolation requirements

List Zones

GET /api/v1/isolation/zones

{
  "zones": [
    {
      "zone_id": "zone_default",
      "name": "Default",
      "classification": "UNCLASSIFIED",
      "allocated_qubits": 0,
      "max_qubits": 50,
      "backend": "aws_ionq_aria_1",
      "status": "active"
    },
    {
      "zone_id": "zone_secure_alpha",
      "name": "Secure Alpha",
      "classification": "RESTRICTED",
      "allocated_qubits": 10,
      "max_qubits": 20,
      "backend": "aws_ionq_aria_1",
      "status": "active"
    }
  ]
}

Allocate a Zone

POST /api/v1/isolation/allocate

{
  "tenant_id": "ten_finance",
  "circuit_width": 6,
  "isolation_level": "strict",
  "duration_seconds": 300
}

Field	Description
`tenant_id`	Tenant the zone belongs to
`circuit_width`	Number of qubits the workload needs
`isolation_level`	Requested isolation level
`duration_seconds`	How long to hold the allocation

Returns the allocated zone_id used for isolated execution. Inspect zones with GET /api/v1/isolation/zones and GET /api/v1/isolation/zones/{zone_id}; release one with DELETE /api/v1/isolation/zones/{zone_id}. For fault-tolerant logical zones (QEC-encoded), use POST /api/v1/qec/isolation/zones with code_id and n_logical_qubits.

Execute Inside a Zone

POST /api/v1/isolation/execute

{
  "zone_id": "zone_secure_alpha",
  "tenant_id": "ten_finance",
  "qasm": "OPENQASM 2.0; ...",
  "shots": 1024,
  "generate_evidence": true
}

With generate_evidence: true the run produces a per-zone evidence record, retrievable at GET /api/v1/isolation/evidence/{evidence_id}.

Measure Crosstalk

GET /api/v1/isolation/crosstalk

Reports the crosstalk isolation picture between active zones, quantifying leakage:

{
  "leakage_rate": 0.0003,
  "pass": true,
  "threshold": 0.001
}

Python Example — Isolated Job Submission

import os
import requests
import time

API_KEY = os.environ["QCOS_API_KEY"]
BASE_URL = "https://api.softquantus.com"
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}

# Step 1: Allocate an isolated zone
alloc = requests.post(
    f"{BASE_URL}/api/v1/isolation/allocate",
    headers=HEADERS,
    json={"tenant_id": "ten_finance", "circuit_width": 4, "duration_seconds": 120}
)
alloc.raise_for_status()
zone_id = alloc.json()["zone_id"]
print(f"Zone allocated: {zone_id}")

# Step 2: Execute inside the zone, with evidence
run = requests.post(
    f"{BASE_URL}/api/v1/isolation/execute",
    headers=HEADERS,
    json={
        "zone_id": zone_id,
        "tenant_id": "ten_finance",
        "qasm": 'OPENQASM 2.0; include "qelib1.inc"; qreg q[4]; creg c[4]; h q[0]; cx q[0],q[1]; cx q[1],q[2]; cx q[2],q[3]; measure q -> c;',
        "shots": 1024,
        "generate_evidence": True
    }
)
run.raise_for_status()
result = run.json()
print(f"Result: {result}")

# Step 3: Release the zone when finished
requests.delete(f"{BASE_URL}/api/v1/isolation/zones/{zone_id}", headers=HEADERS)

Classification Levels

Level	Use Case	Crosstalk Threshold
`UNCLASSIFIED`	General research, development	Not enforced
`RESTRICTED`	Commercial IP, financial models	< 0.1% leakage
`CONFIDENTIAL`	Enterprise secrets, PII adjacent	< 0.01% leakage
`SECRET`	Government, defence research	< 0.001% leakage

Core

Modules

Certification

Qubit Isolation Zones

Qubit Isolation Zones

Use Cases

List Zones

Allocate a Zone

Execute Inside a Zone

Measure Crosstalk

Python Example — Isolated Job Submission

Classification Levels

​Qubit Isolation Zones

​Use Cases

​List Zones

​Allocate a Zone

​Execute Inside a Zone

​Measure Crosstalk

​Python Example — Isolated Job Submission

​Classification Levels

​Related

Qubit Isolation Zones

Use Cases

List Zones

Allocate a Zone

Execute Inside a Zone

Measure Crosstalk

Python Example — Isolated Job Submission

Classification Levels

Related