openapi: 3.0.3
info:
  title: D-Wave Solver API (SAPI) - Solvers
  version: '3.0'
  description: |
    D-Wave Solver API (SAPI) — Solvers resource. Discover quantum (QPU) and hybrid solvers
    available to the authenticated project on the Leap quantum cloud service. Each solver
    advertises its capability metadata (problem types, parameters, properties, status).
  contact:
    name: D-Wave Quantum Inc.
    url: https://docs.dwavequantum.com/en/latest/ocean/api_ref_cloud/index.html
  license:
    name: Proprietary
    url: https://www.dwavequantum.com/legal/terms/
servers:
- url: https://cloud.dwavesys.com/sapi/v2
  description: Default Leap SAPI endpoint (use Metadata API for region routing)
- url: https://eu-central-1.cloud.dwavesys.com/sapi/v2
  description: EU Central regional SAPI endpoint
security:
- SapiToken: []
paths:
  /solvers/remote/:
    get:
      operationId: listSolvers
      summary: List Solvers
      description: List remote solvers available to the authenticated project, with optional filter.
      tags: [Solvers]
      parameters:
      - in: query
        name: filter
        description: Solver filter expression (e.g. `none,+properties.topology.type`).
        schema:
          type: string
      responses:
        '200':
          description: Solver list
          content:
            application/vnd.dwave.sapi.solver-definition-list+json;version=3.0.0:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SolverConfiguration'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /solvers/remote/{solver_name}:
    get:
      operationId: getSolver
      summary: Get Solver
      description: Retrieve full configuration and properties for a single solver.
      tags: [Solvers]
      parameters:
      - in: path
        name: solver_name
        required: true
        schema: {type: string}
      - in: query
        name: filter
        schema: {type: string}
      responses:
        '200':
          description: Solver configuration
          content:
            application/vnd.dwave.sapi.solver-definition+json;version=3.0.0:
              schema:
                $ref: '#/components/schemas/SolverConfiguration'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  securitySchemes:
    SapiToken:
      type: apiKey
      in: header
      name: X-Auth-Token
      description: Project-scoped SAPI token retrieved via the Leap Account API.
  schemas:
    SolverConfiguration:
      type: object
      required: [id, status, properties]
      properties:
        id:
          type: string
          example: Advantage_system6.4
        status:
          type: string
          enum: [ONLINE, OFFLINE, UNKNOWN]
        description:
          type: string
        avg_load:
          type: number
        properties:
          type: object
          description: Solver capability metadata (qubits, topology, supported problem types, ranges).
          properties:
            category:
              type: string
              enum: [qpu, hybrid, software]
            supported_problem_types:
              type: array
              items:
                type: string
                enum: [ising, qubo, bqm, cqm, dqm, nl]
            num_qubits:
              type: integer
            topology:
              type: object
              properties:
                type: {type: string, enum: [pegasus, zephyr, chimera]}
                shape: {type: array, items: {type: integer}}
            parameters:
              type: object
              additionalProperties: true
  responses:
    Unauthorized:
      description: Missing or invalid SAPI token
    NotFound:
      description: Solver not found or not accessible to project