Qovery API — Deployment Stage Main Calls

naftiko: 1.0.0-alpha2
info:
  label: Qovery API — Deployment Stage Main Calls
  description: 'Qovery API — Deployment Stage Main Calls. 9 operations. Lead operation: Get Deployment Stage. Self-contained
    Naftiko capability covering one Qovery business surface.'
  tags:
  - Qovery
  - Deployment Stage Main Calls
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    QOVERY_API_KEY: QOVERY_API_KEY
capability:
  consumes:
  - type: http
    namespace: qovery-deployment-stage-main-calls
    baseUri: https://api.qovery.com
    description: Qovery API — Deployment Stage Main Calls business capability. Self-contained, no shared references.
    resources:
    - name: deploymentStage-deploymentStageId
      path: /deploymentStage/{deploymentStageId}
      operations:
      - name: getdeploymentstage
        method: GET
        description: Get Deployment Stage
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deletedeploymentstage
        method: DELETE
        description: Delete deployment stage
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: editdeploymentstage
        method: PUT
        description: Edit deployment stage
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: deploymentStage-deploymentStageId-moveAfter-stageId
      path: /deploymentStage/{deploymentStageId}/moveAfter/{stageId}
      operations:
      - name: moveafterdeploymentstage
        method: PUT
        description: Move deployment stage after requested stage
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: deploymentStage-deploymentStageId-moveBefore-stageId
      path: /deploymentStage/{deploymentStageId}/moveBefore/{stageId}
      operations:
      - name: movebeforedeploymentstage
        method: PUT
        description: Move deployment stage before requested stage
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: deploymentStage-deploymentStageId-service-serviceId
      path: /deploymentStage/{deploymentStageId}/service/{serviceId}
      operations:
      - name: attachservicetodeploymentstage
        method: PUT
        description: Attach service to deployment stage
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: environment-environmentId-deploymentStage
      path: /environment/{environmentId}/deploymentStage
      operations:
      - name: listenvironmentdeploymentstage
        method: GET
        description: List environment deployment stage
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createenvironmentdeploymentstage
        method: POST
        description: Create environment deployment stage
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: service-serviceId-deploymentStage
      path: /service/{serviceId}/deploymentStage
      operations:
      - name: getservicedeploymentstage
        method: GET
        description: Get Service Deployment Stage
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      token: '{{env.QOVERY_API_KEY}}'
  exposes:
  - type: rest
    namespace: qovery-deployment-stage-main-calls-rest
    port: 8080
    description: REST adapter for Qovery API — Deployment Stage Main Calls. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/deploymentstage/{deploymentstageid}
      name: deploymentstage-deploymentstageid
      description: REST surface for deploymentStage-deploymentStageId.
      operations:
      - method: GET
        name: getdeploymentstage
        description: Get Deployment Stage
        call: qovery-deployment-stage-main-calls.getdeploymentstage
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deletedeploymentstage
        description: Delete deployment stage
        call: qovery-deployment-stage-main-calls.deletedeploymentstage
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: editdeploymentstage
        description: Edit deployment stage
        call: qovery-deployment-stage-main-calls.editdeploymentstage
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/deploymentstage/{deploymentstageid}/moveafter/{stageid}
      name: deploymentstage-deploymentstageid-moveafter-stageid
      description: REST surface for deploymentStage-deploymentStageId-moveAfter-stageId.
      operations:
      - method: PUT
        name: moveafterdeploymentstage
        description: Move deployment stage after requested stage
        call: qovery-deployment-stage-main-calls.moveafterdeploymentstage
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/deploymentstage/{deploymentstageid}/movebefore/{stageid}
      name: deploymentstage-deploymentstageid-movebefore-stageid
      description: REST surface for deploymentStage-deploymentStageId-moveBefore-stageId.
      operations:
      - method: PUT
        name: movebeforedeploymentstage
        description: Move deployment stage before requested stage
        call: qovery-deployment-stage-main-calls.movebeforedeploymentstage
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/deploymentstage/{deploymentstageid}/service/{serviceid}
      name: deploymentstage-deploymentstageid-service-serviceid
      description: REST surface for deploymentStage-deploymentStageId-service-serviceId.
      operations:
      - method: PUT
        name: attachservicetodeploymentstage
        description: Attach service to deployment stage
        call: qovery-deployment-stage-main-calls.attachservicetodeploymentstage
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/environment/{environmentid}/deploymentstage
      name: environment-environmentid-deploymentstage
      description: REST surface for environment-environmentId-deploymentStage.
      operations:
      - method: GET
        name: listenvironmentdeploymentstage
        description: List environment deployment stage
        call: qovery-deployment-stage-main-calls.listenvironmentdeploymentstage
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createenvironmentdeploymentstage
        description: Create environment deployment stage
        call: qovery-deployment-stage-main-calls.createenvironmentdeploymentstage
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/service/{serviceid}/deploymentstage
      name: service-serviceid-deploymentstage
      description: REST surface for service-serviceId-deploymentStage.
      operations:
      - method: GET
        name: getservicedeploymentstage
        description: Get Service Deployment Stage
        call: qovery-deployment-stage-main-calls.getservicedeploymentstage
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: qovery-deployment-stage-main-calls-mcp
    port: 9090
    transport: http
    description: MCP adapter for Qovery API — Deployment Stage Main Calls. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: get-deployment-stage
      description: Get Deployment Stage
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: qovery-deployment-stage-main-calls.getdeploymentstage
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-deployment-stage
      description: Delete deployment stage
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: qovery-deployment-stage-main-calls.deletedeploymentstage
      outputParameters:
      - type: object
        mapping: $.
    - name: edit-deployment-stage
      description: Edit deployment stage
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: qovery-deployment-stage-main-calls.editdeploymentstage
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: move-deployment-stage-after-requested
      description: Move deployment stage after requested stage
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: qovery-deployment-stage-main-calls.moveafterdeploymentstage
      outputParameters:
      - type: object
        mapping: $.
    - name: move-deployment-stage-before-requested
      description: Move deployment stage before requested stage
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: qovery-deployment-stage-main-calls.movebeforedeploymentstage
      outputParameters:
      - type: object
        mapping: $.
    - name: attach-service-deployment-stage
      description: Attach service to deployment stage
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: qovery-deployment-stage-main-calls.attachservicetodeploymentstage
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: list-environment-deployment-stage
      description: List environment deployment stage
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: qovery-deployment-stage-main-calls.listenvironmentdeploymentstage
      outputParameters:
      - type: object
        mapping: $.
    - name: create-environment-deployment-stage
      description: Create environment deployment stage
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: qovery-deployment-stage-main-calls.createenvironmentdeploymentstage
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-service-deployment-stage
      description: Get Service Deployment Stage
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: qovery-deployment-stage-main-calls.getservicedeploymentstage
      outputParameters:
      - type: object
        mapping: $.