Microsoft Azure Quantum Workspaces API

openapi: 3.2.0
info:
  title: Azure Quantum Workspace Services Offerings Workspaces 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: Workspaces
paths:
  /subscriptions/{subscriptionId}/providers/Microsoft.Quantum/locations/{location}/checkNameAvailability:
    post:
      operationId: Workspaces_CheckNameAvailability
      tags:
      - Workspaces
      description: Check the availability of the resource name for the given location.
      parameters:
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/LocationParameter
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: ../../../../../common-types/resource-management/v5/types.json#/definitions/CheckNameAvailabilityResponse
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: ../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Workspaces_CheckNameAvailability:
          $ref: ./examples/Workspaces_CheckNameAvailability.json
      requestBody:
        content:
          application/json:
            schema:
              $ref: ../../../../../common-types/resource-management/v5/types.json#/definitions/CheckNameAvailabilityRequest
        description: The CheckAvailability request
        required: true
  /subscriptions/{subscriptionId}/providers/Microsoft.Quantum/workspaces:
    get:
      operationId: Workspaces_ListBySubscription
      tags:
      - Workspaces
      description: Gets the list of Workspaces within a Subscription.
      parameters:
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QuantumWorkspaceListResult'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: ../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Workspaces_ListBySubscription:
          $ref: ./examples/Workspaces_ListBySubscription.json
      x-ms-pageable:
        nextLinkName: nextLink
  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces:
    get:
      operationId: Workspaces_ListByResourceGroup
      tags:
      - Workspaces
      description: Gets the list of Workspaces within a resource group.
      parameters:
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QuantumWorkspaceListResult'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: ../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Workspaces_ListByResourceGroup:
          $ref: ./examples/Workspaces_ListByResourceGroup.json
      x-ms-pageable:
        nextLinkName: nextLink
  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}:
    get:
      operationId: Workspaces_Get
      tags:
      - Workspaces
      description: Returns the Workspace resource associated with the given name.
      parameters:
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: workspaceName
        in: path
        description: The name of the quantum workspace resource.
        required: true
        schema:
          type: string
          pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QuantumWorkspace'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: ../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Workspaces_Get:
          $ref: ./examples/Workspaces_Get.json
    put:
      operationId: Workspaces_CreateOrUpdate
      tags:
      - Workspaces
      description: Creates or updates a Workspace resource.
      parameters:
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: workspaceName
        in: path
        description: The name of the quantum workspace resource.
        required: true
        schema:
          type: string
          pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$
      responses:
        '200':
          description: Resource 'QuantumWorkspace' update operation succeeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QuantumWorkspace'
        '201':
          description: Resource 'QuantumWorkspace' create operation succeeded
          headers:
            Azure-AsyncOperation:
              description: A link to the status monitor
              schema:
                type: string
            Retry-After:
              description: The Retry-After header can indicate how long the client should wait before polling the operation status.
              schema:
                type: integer
                format: int32
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QuantumWorkspace'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: ../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Workspaces_CreateOrUpdate:
          $ref: ./examples/Workspaces_CreateOrUpdate.json
      x-ms-long-running-operation-options:
        final-state-via: azure-async-operation
      x-ms-long-running-operation: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/QuantumWorkspace'
        description: Workspace details.
        required: true
    patch:
      operationId: Workspaces_UpdateTags
      tags:
      - Workspaces
      description: Updates an existing Workspace's tags.
      parameters:
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: workspaceName
        in: path
        description: The name of the quantum workspace resource.
        required: true
        schema:
          type: string
          pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QuantumWorkspace'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: ../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Workspaces_UpdateTags:
          $ref: ./examples/Workspaces_UpdateTags.json
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/QuantumWorkspaceTagsUpdate'
        description: Parameters supplied to update tags.
        required: true
    delete:
      operationId: Workspaces_Delete
      tags:
      - Workspaces
      description: Deletes a Workspace resource.
      parameters:
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: workspaceName
        in: path
        description: The name of the quantum workspace resource.
        required: true
        schema:
          type: string
          pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$
      responses:
        '202':
          description: Resource deletion accepted.
          headers:
            Location:
              description: The Location header contains the URL where the status of the long running operation can be checked.
              schema:
                type: string
            Retry-After:
              description: The Retry-After header can indicate how long the client should wait before polling the operation status.
              schema:
                type: integer
                format: int32
        '204':
          description: Resource does not exist.
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: ../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Workspaces_Delete:
          $ref: ./examples/Workspaces_Delete.json
      x-ms-long-running-operation-options:
        final-state-via: location
      x-ms-long-running-operation: true
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/listKeys
  : post:
      operationId: Workspaces_ListKeys
      tags:
      - Workspaces
      description: Get the keys to use with the Quantum APIs. A key is used to authenticate and authorize access to the Quantum REST APIs. Only one key is needed at a time; two are given to provide seamless key regeneration.
      parameters:
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: workspaceName
        in: path
        description: The name of the quantum workspace resource.
        required: true
        schema:
          type: string
          pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListKeysResult'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: ../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Workspaces_ListKeys:
          $ref: ./examples/Workspaces_ListKeys.json
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/regenerateKey
  : post:
      operationId: Workspaces_RegenerateKeys
      tags:
      - Workspaces
      description: Regenerate either the primary or secondary key for use with the Quantum APIs. The old key will stop working immediately.
      parameters:
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: workspaceName
        in: path
        description: The name of the quantum workspace resource.
        required: true
        schema:
          type: string
          pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$
      responses:
        '204':
          description: There is no content to send for this request, but the headers may be useful.
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: ../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Workspaces_RegenerateKeys:
          $ref: ./examples/Workspaces_RegenerateKeys.json
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApiKeys'
        description: 'Which key to regenerate:  primary or secondary.'
        required: true
components:
  schemas:
    ApiKey:
      type: object
      description: Azure quantum workspace Api key details.
      properties:
        createdAt:
          type: string
          format: date-time
          description: The creation time of the api key.
        key:
          type: string
          description: The Api key.
          readOnly: true
    QuotaAllocations:
      type: object
      description: Quota allocations with each field representing different quota type.
      properties:
        standardMinutesLifetime:
          type: integer
          format: int32
          description: Lifetime limit for standard priority jobs execution in minutes.
          minimum: 0
        highMinutesLifetime:
          type: integer
          format: int32
          description: Lifetime limit for high priority jobs execution in minutes.
          minimum: 0
      required:
      - standardMinutesLifetime
    ProviderStatus:
      type: string
      description: Provisioning status field
      enum:
      - Succeeded
      - Launching
      - Updating
      - Deleting
      - Deleted
      - Failed
      x-ms-enum:
        name: ProviderStatus
        modelAsString: true
        values:
        - name: Succeeded
          value: Succeeded
          description: The provider is successfully provisioned.
        - name: Launching
          value: Launching
          description: The provider is starting provisioning.
        - name: Updating
          value: Updating
          description: The provider is updating.
        - name: Deleting
          value: Deleting
          description: The provider is deleting.
        - name: Deleted
          value: Deleted
          description: The provider is deleted.
        - name: Failed
          value: Failed
          description: The provider is failed.
    Provider:
      type: object
      description: Information about a Provider. A Provider is an entity that offers Targets to run Azure Quantum Jobs.
      properties:
        providerId:
          type: string
          description: Unique id of this provider.
        providerSku:
          type: string
          description: The sku associated with pricing information for this provider.
        instanceUri:
          type: string
          description: A Uri identifying the specific instance of this provider.
        applicationName:
          type: string
          description: The provider's marketplace application display name.
        provisioningState:
          $ref: '#/components/schemas/ProviderStatus'
          description: Provisioning status field
        resourceUsageId:
          type: string
          description: Id to track resource usage for the provider.
        quotas:
          $ref: '#/components/schemas/QuotaAllocations'
          description: Quota allocations associated with this provider. Available only for special providers.
    ListKeysResult:
      type: object
      description: Result of list Api keys and connection strings.
      properties:
        apiKeyEnabled:
          type: boolean
          description: Indicator of enablement of the Quantum workspace Api keys.
        primaryKey:
          $ref: '#/components/schemas/ApiKey'
          description: The quantum workspace primary api key.
        secondaryKey:
          $ref: '#/components/schemas/ApiKey'
          description: The quantum workspace secondary api key.
        primaryConnectionString:
          type: string
          description: The connection string of the primary api key.
          readOnly: true
        secondaryConnectionString:
          type: string
          description: The connection string of the secondary api key.
          readOnly: true
    QuantumWorkspace:
      type: object
      description: The resource proxy definition object for Quantum Workspace.
      properties:
        properties:
          $ref: '#/components/schemas/WorkspaceResourceProperties'
          description: Gets or sets the properties. Define quantum workspace's specific properties.
        identity:
          $ref: ../../../../../common-types/resource-management/v5/managedidentity.json#/definitions/ManagedServiceIdentity
          description: The managed service identities assigned to this resource.
      allOf:
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/definitions/TrackedResource
    WorkspaceProvisioningStatus:
      type: string
      description: The Workspace provisioning status.
      enum:
      - Succeeded
      - Failed
      - Canceled
      - ProviderLaunching
      - ProviderUpdating
      - ProviderDeleting
      - ProviderProvisioning
      x-ms-enum:
        name: WorkspaceProvisioningStatus
        modelAsString: true
        values:
        - name: Succeeded
          value: Succeeded
          description: The Workspace provisioning is succeeded.
        - name: Failed
          value: Failed
          description: The Workspace provisioning failed.
        - name: Canceled
          value: Canceled
          description: Resource creation was canceled.
        - name: ProviderLaunching
          value: ProviderLaunching
          description: The Workspace is currently starting to provision a provider.
        - name: ProviderUpdating
          value: ProviderUpdating
          description: The Workspace is currently updating a provider.
        - name: ProviderDeleting
          value: ProviderDeleting
          description: The Workspace is currently deleting a provider.
        - name: ProviderProvisioning
          value: ProviderProvisioning
          description: The Workspace is currently provisioning a provider.
    UsableStatus:
      type: string
      description: Whether the current workspace is ready to accept Jobs.
      enum:
      - 'Yes'
      - 'No'
      - Partial
      x-ms-enum:
        name: UsableStatus
        modelAsString: true
        values:
        - name: 'Yes'
          value: 'Yes'
          description: The workspace is usable and can accept jobs.
        - name: 'No'
          value: 'No'
          description: The workspace is not usable and cannot accept jobs.
        - name: Partial
          value: Partial
          description: The workspace is partially usable.
    StorageAccountResourceId:
      type: string
      format: arm-id
      description: ARM Resource Id of a storage account.
      x-ms-arm-id-details:
        allowedResources:
        - type: Microsoft.Storage/storageAccounts
    WorkspaceResourceProperties:
      type: object
      description: Properties of a Workspace
      properties:
        providers:
          type: array
          description: List of Providers selected for this Workspace
          items:
            $ref: '#/components/schemas/Provider'
          x-ms-identifiers:
          - providerId
        usable:
          $ref: '#/components/schemas/UsableStatus'
          description: Whether the current workspace is ready to accept Jobs.
          readOnly: true
        provisioningState:
          $ref: '#/components/schemas/WorkspaceProvisioningStatus'
          description: Provisioning status field
          readOnly: true
        storageAccount:
          $ref: '#/components/schemas/StorageAccountResourceId'
          description: ARM Resource Id of the storage account associated with this workspace.
        workspaceKind:
          $ref: '#/components/schemas/WorkspaceKind'
          description: Whether this workspace is V1 or V2.
        endpointUri:
          type: string
          description: The URI of the workspace endpoint.
          readOnly: true
        apiKeyEnabled:
          type: boolean
          description: Indicator of enablement of the Quantum workspace Api keys.
        managedOnBehalfOfConfiguration:
          $ref: ../../../../../common-types/resource-management/v5/mobo.json#/definitions/ManagedOnBehalfOfConfiguration
          description: Managed On Behalf Of configuration.
          readOnly: true
        managedStorageAccount:
          $ref: '#/components/schemas/StorageAccountResourceId'
          description: ARM Resource Id of the managed storage account associated with this workspace.
          readOnly: true
    ApiKeys:
      type: object
      description: List of api keys to be generated.
      properties:
        keys:
          type: array
          description: A list of api key names.
          items:
            $ref: '#/components/schemas/KeyType'
    QuantumWorkspaceTagsUpdate:
      type: object
      description: The type used for updating tags in QuantumWorkspace resources.
      properties:
        tags:
          type: object
          description: Resource tags.
          additionalProperties:
            type: string
    WorkspaceKind:
      type: string
      description: The workspace type.
      enum:
      - V1
      - V2
      x-ms-enum:
        name: WorkspaceKind
        modelAsString: true
        values:
        - name: V1
          value: V1
          description: The workspace is a general-purpose workspace.
        - name: V2
          value: V2
          description: The workspace is a V2 workspace.
    KeyType:
      type: string
      description: The API key type.
      enum:
      - Primary
      - Secondary
      x-ms-enum:
        name: KeyType
        modelAsString: true
        values:
        - name: Primary
          value: Primary
          description: The primary API key.
        - name: Secondary
          value: Secondary
          description: The secondary API key.
    QuantumWorkspaceListResult:
      type: object
      description: The response of a QuantumWorkspace list operation.
      properties:
        value:
          type: array
          description: The QuantumWorkspace items on this page
          items:
            $ref: '#/components/schemas/QuantumWorkspace'
        nextLink:
          type: string
          format: uri
          description: The link to the next page of items
      required:
      - value
  securitySchemes:
    AzureApiKeyAuth:
      type: apiKey
      description: Azure Api-Key Authentication
      name: x-ms-quantum-api-key
      in: header
    AzureEntraAuth:
      type: oauth2
      flows:
        clientCredentials:
          scopes:
            https://quantum.microsoft.com/.default: ''
          tokenUrl: https://login.microsoftonline.com/common/oauth2/v2.0/token
      description: Azure Entra OAuth2 Authentication
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - name: endpoint
    in: path
    description: The endpoint of the Azure Quantum service. For example, https://{region}.quantum.azure.com
    required: true
    type: string
    format: uri
    x-ms-skip-url-encoding: true