Azure Quantum Workspace — Jobs

naftiko: 1.0.0-alpha2
info:
  label: Azure Quantum Workspace — Jobs
  description: >-
    Azure Quantum Workspace data-plane Jobs capability. Submit, list, get,
    update, and cancel quantum jobs across IonQ, Quantinuum, Pasqal, and Rigetti
    targets in an Azure Quantum workspace.
  tags:
    - Azure Quantum
    - Jobs
    - Quantum Computing
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
  - namespace: env
    keys:
      AZURE_QUANTUM_BEARER: AZURE_QUANTUM_BEARER
      AZURE_SUBSCRIPTION_ID: AZURE_SUBSCRIPTION_ID
      AZURE_RESOURCE_GROUP: AZURE_RESOURCE_GROUP
      AZURE_QUANTUM_WORKSPACE: AZURE_QUANTUM_WORKSPACE
capability:
  consumes:
    - type: http
      namespace: jobs-jobs
      baseUri: https://management.azure.com
      description: Workspace data-plane Jobs operations.
      resources:
        - name: jobs
          path: /subscriptions/{{env.AZURE_SUBSCRIPTION_ID}}/resourceGroups/{{env.AZURE_RESOURCE_GROUP}}/providers/Microsoft.Quantum/workspaces/{{env.AZURE_QUANTUM_WORKSPACE}}/jobs
          operations:
            - name: listjobs
              method: GET
              description: List Jobs In The Workspace.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: api-version
                  in: query
                  type: string
                  required: true
                  default: 2026-01-15-preview
            - name: submitjob
              method: PUT
              description: Submit A Quantum Job.
              outputRawFormat: json
              inputParameters:
                - name: body
                  in: body
                  type: object
                  required: true
        - name: job-by-id
          path: /subscriptions/{{env.AZURE_SUBSCRIPTION_ID}}/resourceGroups/{{env.AZURE_RESOURCE_GROUP}}/providers/Microsoft.Quantum/workspaces/{{env.AZURE_QUANTUM_WORKSPACE}}/jobs/{jobId}
          operations:
            - name: getjob
              method: GET
              description: Get Job By Identifier.
            - name: deletejob
              method: DELETE
              description: Delete A Job.
        - name: job-cancel
          path: /subscriptions/{{env.AZURE_SUBSCRIPTION_ID}}/resourceGroups/{{env.AZURE_RESOURCE_GROUP}}/providers/Microsoft.Quantum/workspaces/{{env.AZURE_QUANTUM_WORKSPACE}}/jobs/{jobId}:cancel
          operations:
            - name: canceljob
              method: POST
              description: Request Cancellation Of A Running Job.
        - name: job-update-options
          path: /subscriptions/{{env.AZURE_SUBSCRIPTION_ID}}/resourceGroups/{{env.AZURE_RESOURCE_GROUP}}/providers/Microsoft.Quantum/workspaces/{{env.AZURE_QUANTUM_WORKSPACE}}/jobUpdateOptions/{jobId}
          operations:
            - name: updatejob
              method: PATCH
              description: Update Patchable Job Properties.
      authentication:
        type: bearer
        value: '{{env.AZURE_QUANTUM_BEARER}}'
        placement: header
  exposes:
    - type: rest
      namespace: jobs-jobs-rest
      port: 8080
      description: REST adapter for Azure Quantum Workspace Jobs.
      resources:
        - path: /v1/jobs
          name: jobs
          operations:
            - method: GET
              name: listjobs
              description: List Jobs.
              call: jobs-jobs.listjobs
            - method: POST
              name: submitjob
              description: Submit A Quantum Job.
              call: jobs-jobs.submitjob
        - path: /v1/jobs/{jobId}
          name: job-by-id
          operations:
            - method: GET
              name: getjob
              call: jobs-jobs.getjob
            - method: DELETE
              name: deletejob
              call: jobs-jobs.deletejob
        - path: /v1/jobs/{jobId}/cancel
          name: job-cancel
          operations:
            - method: POST
              name: canceljob
              call: jobs-jobs.canceljob
    - type: mcp
      namespace: jobs-jobs-mcp
      port: 9090
      transport: http
      description: MCP adapter for Azure Quantum Jobs.
      tools:
        - name: azure-quantum-list-jobs
          description: List quantum jobs in an Azure Quantum workspace.
          hints:
            readOnly: true
          call: jobs-jobs.listjobs
        - name: azure-quantum-submit-job
          description: Submit a quantum job to an Azure Quantum target.
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: jobs-jobs.submitjob
        - name: azure-quantum-get-job
          description: Retrieve a quantum job by identifier.
          hints:
            readOnly: true
          call: jobs-jobs.getjob
        - name: azure-quantum-cancel-job
          description: Request cancellation of a running quantum job.
          hints:
            readOnly: false
            destructive: true
          call: jobs-jobs.canceljob