Microsoft Azure Quantum Subscriptions API

openapi: 3.2.0
info:
  title: Azure Quantum Workspace Services Offerings Subscriptions API
  version: 2026-01-15-preview
  description: Azure Quantum Workspace Services
  contact:
    email: azqengg@microsoft.com
  x-typespec-generated:
  - emitter: '@azure-tools/typespec-autorest'
security:
- AzureEntraAuth:
  - https://quantum.microsoft.com/.default
- AzureApiKeyAuth: []
tags:
- name: Subscriptions
paths:
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/jobUpdateOptions/{jobId}
  : patch:
      operationId: Jobs_Update
      description: Update job properties.
      parameters:
      - $ref: '#/components/parameters/Azure.Core.Foundations.ApiVersionParameter'
      - name: subscriptionId
        in: path
        description: The Azure subscription ID.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 36
          minLength: 36
          pattern: ^[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$
      - name: resourceGroupName
        in: path
        description: Name of the Azure resource group.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 90
          minLength: 1
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_\.]*$
      - name: workspaceName
        in: path
        description: Name of the Azure Quantum workspace.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 50
          minLength: 2
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_]*$
      - name: jobId
        in: path
        description: Id of the job.
        required: true
        schema:
          type: string
          maxLength: 36
          pattern: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobUpdateOptions'
        default:
          description: An unexpected error response.
          headers:
            x-ms-error-code:
              description: String error code indicating what went wrong.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
      x-ms-examples:
        Patches a job.:
          $ref: ./examples/Jobs_Update.json
      tags:
      - Subscriptions
      requestBody:
        content:
          application/merge-patch+json:
            schema:
              $ref: '#/components/schemas/JobUpdateOptionsUpdate'
        description: The resource instance.
        required: true
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/jobs
  : get:
      operationId: Jobs_List
      description: List all jobs.
      parameters:
      - $ref: '#/components/parameters/Azure.Core.Foundations.ApiVersionParameter'
      - name: subscriptionId
        in: path
        description: The Azure subscription ID.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 36
          minLength: 36
          pattern: ^[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$
      - name: resourceGroupName
        in: path
        description: Name of the Azure resource group.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 90
          minLength: 1
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_\.]*$
      - name: workspaceName
        in: path
        description: Name of the Azure Quantum workspace.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 50
          minLength: 2
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_]*$
      - $ref: '#/components/parameters/CustomFilterQueryParameter'
      - $ref: '#/components/parameters/CustomSkipQueryParameter'
      - $ref: '#/components/parameters/CustomTopQueryParameter'
      - $ref: '#/components/parameters/CustomOrderByQueryParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PagedJobDetails'
        default:
          description: An unexpected error response.
          headers:
            x-ms-error-code:
              description: String error code indicating what went wrong.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
      x-ms-examples:
        List jobs in a workspace.:
          $ref: ./examples/Jobs_List.json
      x-ms-pageable:
        nextLinkName: nextLink
      tags:
      - Subscriptions
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/jobs/{jobId}
  : get:
      operationId: Jobs_Get
      description: Get job by its id.
      parameters:
      - $ref: '#/components/parameters/Azure.Core.Foundations.ApiVersionParameter'
      - name: subscriptionId
        in: path
        description: The Azure subscription ID.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 36
          minLength: 36
          pattern: ^[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$
      - name: resourceGroupName
        in: path
        description: Name of the Azure resource group.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 90
          minLength: 1
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_\.]*$
      - name: workspaceName
        in: path
        description: Name of the Azure Quantum workspace.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 50
          minLength: 2
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_]*$
      - name: jobId
        in: path
        description: Id of the job.
        required: true
        schema:
          type: string
          maxLength: 36
          pattern: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobDetails'
        default:
          description: An unexpected error response.
          headers:
            x-ms-error-code:
              description: String error code indicating what went wrong.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
      x-ms-examples:
        Gets a job by its id.:
          $ref: ./examples/Jobs_Get.json
      tags:
      - Subscriptions
    put:
      operationId: Jobs_Create
      description: Create a new job.
      parameters:
      - $ref: '#/components/parameters/Azure.Core.Foundations.ApiVersionParameter'
      - name: subscriptionId
        in: path
        description: The Azure subscription ID.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 36
          minLength: 36
          pattern: ^[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$
      - name: resourceGroupName
        in: path
        description: Name of the Azure resource group.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 90
          minLength: 1
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_\.]*$
      - name: workspaceName
        in: path
        description: Name of the Azure Quantum workspace.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 50
          minLength: 2
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_]*$
      - name: jobId
        in: path
        description: Id of the job.
        required: true
        schema:
          type: string
          maxLength: 36
          pattern: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobDetails'
        '201':
          description: The request has succeeded and a new resource has been created as a result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobDetails'
        default:
          description: An unexpected error response.
          headers:
            x-ms-error-code:
              description: String error code indicating what went wrong.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
      x-ms-examples:
        Creates a job.:
          $ref: ./examples/Jobs_Create.json
      tags:
      - Subscriptions
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/JobDetails'
        description: The resource instance.
        required: true
    delete:
      operationId: Jobs_Delete
      description: Delete a job by its id. Use for cancellation in versions before 2025-12-01-preview.
      parameters:
      - $ref: '#/components/parameters/Azure.Core.Foundations.ApiVersionParameter'
      - name: subscriptionId
        in: path
        description: The Azure subscription ID.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 36
          minLength: 36
          pattern: ^[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$
      - name: resourceGroupName
        in: path
        description: Name of the Azure resource group.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 90
          minLength: 1
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_\.]*$
      - name: workspaceName
        in: path
        description: Name of the Azure Quantum workspace.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 50
          minLength: 2
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_]*$
      - name: jobId
        in: path
        description: Id of the job.
        required: true
        schema:
          type: string
          maxLength: 36
          pattern: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$
      responses:
        '204':
          description: 'There is no content to send for this request, but the headers may be useful. '
        default:
          description: An unexpected error response.
          headers:
            x-ms-error-code:
              description: String error code indicating what went wrong.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
      x-ms-examples:
        Deletes a job by its id.:
          $ref: ./examples/Jobs_Delete.json
      tags:
      - Subscriptions
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/jobs/{jobId}:cancel
  : post:
      operationId: Jobs_Cancel
      description: Request the cancellation of an existing job.
      parameters:
      - $ref: '#/components/parameters/Azure.Core.Foundations.ApiVersionParameter'
      - name: subscriptionId
        in: path
        description: The Azure subscription ID.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 36
          minLength: 36
          pattern: ^[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$
      - name: resourceGroupName
        in: path
        description: Name of the Azure resource group.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 90
          minLength: 1
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_\.]*$
      - name: workspaceName
        in: path
        description: Name of the Azure Quantum workspace.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 50
          minLength: 2
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_]*$
      - name: jobId
        in: path
        description: Id of the job.
        required: true
        schema:
          type: string
          maxLength: 36
          pattern: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobDetails'
        default:
          description: An unexpected error response.
          headers:
            x-ms-error-code:
              description: String error code indicating what went wrong.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
      x-ms-examples:
        Cancels a job.:
          $ref: ./examples/Jobs_Cancel.json
      tags:
      - Subscriptions
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/providerStatus
  : get:
      operationId: Providers_List
      description: List all providers in the workspace with their respective status.
      parameters:
      - $ref: '#/components/parameters/Azure.Core.Foundations.ApiVersionParameter'
      - name: subscriptionId
        in: path
        description: The Azure subscription ID.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 36
          minLength: 36
          pattern: ^[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$
      - name: resourceGroupName
        in: path
        description: Name of the Azure resource group.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 90
          minLength: 1
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_\.]*$
      - name: workspaceName
        in: path
        description: Name of the Azure Quantum workspace.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 50
          minLength: 2
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_]*$
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PagedProviderStatus'
        default:
          description: An unexpected error response.
          headers:
            x-ms-error-code:
              description: String error code indicating what went wrong.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
      x-ms-examples:
        Get provider and target statuses.:
          $ref: ./examples/Providers_List.json
      x-ms-pageable:
        nextLinkName: nextLink
      tags:
      - Subscriptions
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/quotas
  : get:
      operationId: Quotas_List
      description: List quotas for the given workspace.
      parameters:
      - $ref: '#/components/parameters/Azure.Core.Foundations.ApiVersionParameter'
      - name: subscriptionId
        in: path
        description: The Azure subscription ID.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 36
          minLength: 36
          pattern: ^[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$
      - name: resourceGroupName
        in: path
        description: Name of the Azure resource group.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 90
          minLength: 1
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_\.]*$
      - name: workspaceName
        in: path
        description: Name of the Azure Quantum workspace.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 50
          minLength: 2
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_]*$
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PagedQuota'
        default:
          description: An unexpected error response.
          headers:
            x-ms-error-code:
              description: String error code indicating what went wrong.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
      x-ms-examples:
        Get workspace quotas.:
          $ref: ./examples/Quotas_List.json
      x-ms-pageable:
        nextLinkName: nextLink
      tags:
      - Subscriptions
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/sessions
  : get:
      operationId: Sessions_Listv2
      description: List all Sessions.
      parameters:
      - $ref: '#/components/parameters/Azure.Core.Foundations.ApiVersionParameter'
      - name: subscriptionId
        in: path
        description: The Azure subscription ID.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 36
          minLength: 36
          pattern: ^[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$
      - name: resourceGroupName
        in: path
        description: Name of the Azure resource group.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 90
          minLength: 1
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_\.]*$
      - name: workspaceName
        in: path
        description: Name of the Azure Quantum workspace.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 50
          minLength: 2
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_]*$
      - $ref: '#/components/parameters/CustomFilterQueryParameter'
      - $ref: '#/components/parameters/CustomSkipQueryParameter'
      - $ref: '#/components/parameters/CustomTopQueryParameter'
      - $ref: '#/components/parameters/CustomOrderByQueryParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PagedSessionDetails'
        default:
          description: An unexpected error response.
          headers:
            x-ms-error-code:
              description: String error code indicating what went wrong.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
      x-ms-examples:
        List sessions in a workspace.:
          $ref: ./examples/Sessions_List.json
      x-ms-pageable:
        nextLinkName: nextLink
      tags:
      - Subscriptions
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/sessions/{sessionId}
  : get:
      operationId: Sessions_Get
      description: Get Session by its id.
      parameters:
      - $ref: '#/components/parameters/Azure.Core.Foundations.ApiVersionParameter'
      - name: subscriptionId
        in: path
        description: The Azure subscription ID.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 36
          minLength: 36
          pattern: ^[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$
      - name: resourceGroupName
        in: path
        description: Name of the Azure resource group.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 90
          minLength: 1
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_\.]*$
      - name: workspaceName
        in: path
        description: Name of the Azure Quantum workspace.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 50
          minLength: 2
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_]*$
      - name: sessionId
        in: path
        description: Id of the session.
        required: true
        schema:
          type: string
          maxLength: 36
          pattern: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SessionDetails'
        default:
          description: An unexpected error response.
          headers:
            x-ms-error-code:
              description: String error code indicating what went wrong.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
      x-ms-examples:
        Get a session by its id.:
          $ref: ./examples/Sessions_Get.json
      tags:
      - Subscriptions
    put:
      operationId: Sessions_Open
      description: Open a new session.
      parameters:
      - $ref: '#/components/parameters/Azure.Core.Foundations.ApiVersionParameter'
      - name: subscriptionId
        in: path
        description: The Azure subscription ID.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 36
          minLength: 36
          pattern: ^[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$
      - name: resourceGroupName
        in: path
        description: Name of the Azure resource group.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 90
          minLength: 1
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_\.]*$
      - name: workspaceName
        in: path
        description: Name of the Azure Quantum workspace.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 50
          minLength: 2
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_]*$
      - name: sessionId
        in: path
        description: Id of the session.
        required: true
        schema:
          type: string
          maxLength: 36
          pattern: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SessionDetails'
        '201':
          description: The request has succeeded and a new resource has been created as a result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SessionDetails'
        default:
          description: An unexpected error response.
          headers:
            x-ms-error-code:
              description: String error code indicating what went wrong.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
      x-ms-examples:
        Open a session.:
          $ref: ./examples/Sessions_Open.json
      tags:
      - Subscriptions
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SessionDetails'
        description: The resource instance.
        required: true
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/sessions/{sessionId}:close
  : post:
      operationId: Sessions_Close
      description: Close an existing session.
      parameters:
      - $ref: '#/components/parameters/Azure.Core.Foundations.ApiVersionParameter'
      - name: subscriptionId
        in: path
        description: The Azure subscription ID.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 36
          minLength: 36
          pattern: ^[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$
      - name: resourceGroupName
        in: path
        description: Name of the Azure resource group.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 90
          minLength: 1
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_\.]*$
      - name: workspaceName
        in: path
        description: Name of the Azure Quantum workspace.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 50
          minLength: 2
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_]*$
      - name: sessionId
        in: path
        description: Id of the session.
        required: true
        schema:
          type: string
          maxLength: 36
          pattern: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SessionDetails'
        default:
          description: An unexpected error response.
          headers:
            x-ms-error-code:
              description: String error code indicating what went wrong.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
      x-ms-examples:
        Closes a session by its id.:
          $ref: ./examples/Sessions_Close.json
      tags:
      - Subscriptions
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/sessions/{sessionId}/jobs
  : get:
      operationId: SessionsJobs_List
      description: List jobs in a session.
      parameters:
      - $ref: '#/components/parameters/Azure.Core.Foundations.ApiVersionParameter'
      - name: subscriptionId
        in: path
        description: The Azure subscription ID.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 36
          minLength: 36
          pattern: ^[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$
      - name: resourceGroupName
        in: path
        description: Name of the Azure resource group.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 90
          minLength: 1
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_\.]*$
      - name: workspaceName
        in: path
        description: Name of the Azure Quantum workspace.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 50
          minLength: 2
          pattern: ^[a-zA-Z][a-zA-Z0-9\-_]*$
      - name: sessionId
        in: path
        description: Id of the session to list jobs from.
        required: true
        schema:
          type: string
          maxLength: 36
          pattern: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$
      - $ref: '#/components/parameters/CustomFilterQueryParameter'
      - $ref: '#/components/parameters/CustomSkipQueryParameter'
      - $ref: '#/components/parameters/CustomTopQueryParameter'
      - $ref: '#/components/parameters/CustomOrderByQueryParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PagedJobDetails'
        default:
          description: An unexpected error response.
          headers:
            x-ms-error-code:
              description: String error code indicating what went wrong.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
      x-ms-examples:
        List jobs in a workspace.:
          $ref: ./examples/SessionsJobs_List.json
      x-ms-pageable:
        nextLinkName: nextLink
      tags:
      - Subscriptions
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/storage/sasUri
  : post:
      operationId: Storage_GetSasUri
      description: Gets a URL with SAS token for a container/blob in the storage account associated with the workspace. Starting with version 2026-01-15-preview, when used for a container the container is also created if it does not already exist. The SAS URL can be used to upload job input and/or download job output.
      parameters:
      - $ref: '#/components/parameters/Azure.Core.Foundations.ApiVersionParameter'
      - $ref: '#/components/parameters/CommonParams.subscriptionId'
      - $ref: '#/components/parameters/CommonParams.resourceGroupName'
      - $ref: '#/components/parameters/CommonParams.workspaceName'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SasUriResponse'
        default:
          description: An unexpected error response.
          headers:
            x-ms-error-code:
              description: String error code indicating what went wrong.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
      x-ms-examples:
        ? 'Gets a URL with SAS token for a container/blob. When used for a container the container is also created if it does not already exist '
        : $ref: ./examples/Storage_GetSasUri.json
      tags:
      - Subscriptions
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BlobDetails'
        description: The details (name and container) of the blob.
        required: true
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/topLevelItems
  : get:
      operationId: TopLevelItems_Listv2
      description: List top-level items.
      parameters:
      - $ref: '#/components/parameters/Azure.Core.Foundations.ApiVersionParameter'
      - name: subscriptionId
        in: path
        description: The Azure subscription ID.
        required: true
        x-ms-parameter-location: client
        schema:
          type: string
          maxLength: 36
          minLength: 36
          pattern: ^[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$
      - name: r

# --- truncated at 32 KB (62 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-quantum/refs/heads/main/openapi/microsoft-quantum-subscriptions-api-openapi.yml