apiVersion: naftiko.dev/v1
kind: Capability
metadata:
  name: ionq-quantum-cloud-jobs
  provider: ionq
  api: ionq-quantum-cloud-api
  tags:
    - Quantum Computing
    - Jobs
spec:
  summary: Submit, inspect, cancel, and delete quantum circuit jobs on the IonQ Quantum Cloud.
  description: |
    Submit single-circuit, multi-circuit, native-gate, QAOA, or Quantum Function jobs to IonQ
    trapped-ion QPUs (qpu.aria-1, qpu.aria-2, qpu.forte-1, qpu.forte-enterprise-1) and the IonQ
    simulator. Poll status, retrieve aggregated probabilities, per-variant probabilities,
    histograms, and shot data, get cost and estimate, cancel single or many jobs, and delete jobs.
  baseUrl: https://api.ionq.co/v0.4
  authentication:
    type: apiKey
    in: header
    name: Authorization
    valuePrefix: apiKey
  operations:
    - id: createJob
      method: POST
      path: /jobs
      summary: Submit a Quantum Circuit Job
    - id: listJobs
      method: GET
      path: /jobs
      summary: List Jobs
    - id: deleteJobs
      method: DELETE
      path: /jobs
      summary: Delete Many Jobs
    - id: getJob
      method: GET
      path: /jobs/{UUID}
      summary: Get a Specific Job
    - id: deleteJob
      method: DELETE
      path: /jobs/{UUID}
      summary: Delete a Job
    - id: getJobCost
      method: GET
      path: /jobs/{UUID}/cost
      summary: Get Job Cost
    - id: getJobEstimate
      method: GET
      path: /jobs/estimate
      summary: Get a Job Cost Estimate
    - id: getJobCircuits
      method: GET
      path: /jobs/{UUID}/circuits/{lang}
      summary: Get Compiled Circuits for a Job
    - id: cancelJob
      method: PUT
      path: /jobs/{UUID}/status/cancel
      summary: Cancel a Job
    - id: cancelManyJobs
      method: PUT
      path: /jobs/status/cancel
      summary: Cancel Many Jobs
    - id: getJobProbabilities
      method: GET
      path: /jobs/{UUID}/results/probabilities
      summary: Get Aggregated Job Probabilities
    - id: getVariantProbabilities
      method: GET
      path: /jobs/{UUID}/variants/{variantId}/results/probabilities
      summary: Get Probabilities for a Job Variant
    - id: getVariantHistogram
      method: GET
      path: /jobs/{UUID}/variants/{variantId}/results/histogram
      summary: Get Histogram for a Job Variant
    - id: getVariantShots
      method: GET
      path: /jobs/{UUID}/variants/{variantId}/results/shots
      summary: Get Shot Data for a Job Variant