Humanitec API — Set

naftiko: 1.0.0-alpha2
info:
  label: Humanitec API — Set
  description: 'Humanitec API — Set. 5 operations. Lead operation: Get all Deployment Sets. Self-contained Naftiko capability
    covering one Humanitec business surface.'
  tags:
  - Humanitec
  - Set
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    HUMANITEC_API_KEY: HUMANITEC_API_KEY
capability:
  consumes:
  - type: http
    namespace: humanitec-set
    baseUri: https://api.humanitec.io
    description: Humanitec API — Set business capability. Self-contained, no shared references.
    resources:
    - name: orgs-orgId-apps-appId-sets
      path: /orgs/{orgId}/apps/{appId}/sets
      operations:
      - name: listsets
        method: GET
        description: Get all Deployment Sets
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgId-apps-appId-sets-setId
      path: /orgs/{orgId}/apps/{appId}/sets/{setId}
      operations:
      - name: getset
        method: GET
        description: Get a Deployment Set
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: setId
          in: path
          type: string
          description: ID of the Deployment Set.
          required: true
        - name: diff
          in: query
          type: string
          description: ID of the Deployment Set to compared against.
      - name: updateset
        method: POST
        description: Apply a Deployment Delta to a Deployment Set
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: setId
          in: path
          type: string
          description: ID of the Deployment Set.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: orgs-orgId-apps-appId-sets-setId-diff-sourceSetId
      path: /orgs/{orgId}/apps/{appId}/sets/{setId}/diff/{sourceSetId}
      operations:
      - name: getdiff
        method: GET
        description: Get the difference between 2 Deployment Sets
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: setId
          in: path
          type: string
          description: ID of the Deployment Set.
          required: true
        - name: sourceSetId
          in: path
          type: string
          description: ID of the Deployment Set to diff against.
          required: true
    - name: orgs-orgId-apps-appId-sets-setId-resources
      path: /orgs/{orgId}/apps/{appId}/sets/{setId}/resources
      operations:
      - name: getsetresourceinputs
        method: GET
        description: Get Resource Inputs for the given Deployment Set
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: setId
          in: path
          type: string
          description: ID of the Deployment Set.
          required: true
  exposes:
  - type: rest
    namespace: humanitec-set-rest
    port: 8080
    description: REST adapter for Humanitec API — Set. One Spectral-compliant resource per consumed operation, prefixed with
      /v1.
    resources:
    - path: /v1/orgs/{orgid}/apps/{appid}/sets
      name: orgs-orgid-apps-appid-sets
      description: REST surface for orgs-orgId-apps-appId-sets.
      operations:
      - method: GET
        name: listsets
        description: Get all Deployment Sets
        call: humanitec-set.listsets
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/orgs/{orgid}/apps/{appid}/sets/{setid}
      name: orgs-orgid-apps-appid-sets-setid
      description: REST surface for orgs-orgId-apps-appId-sets-setId.
      operations:
      - method: GET
        name: getset
        description: Get a Deployment Set
        call: humanitec-set.getset
        with:
          setId: rest.setId
          diff: rest.diff
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: updateset
        description: Apply a Deployment Delta to a Deployment Set
        call: humanitec-set.updateset
        with:
          setId: rest.setId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/orgs/{orgid}/apps/{appid}/sets/{setid}/diff/{sourcesetid}
      name: orgs-orgid-apps-appid-sets-setid-diff-sourcesetid
      description: REST surface for orgs-orgId-apps-appId-sets-setId-diff-sourceSetId.
      operations:
      - method: GET
        name: getdiff
        description: Get the difference between 2 Deployment Sets
        call: humanitec-set.getdiff
        with:
          setId: rest.setId
          sourceSetId: rest.sourceSetId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/orgs/{orgid}/apps/{appid}/sets/{setid}/resources
      name: orgs-orgid-apps-appid-sets-setid-resources
      description: REST surface for orgs-orgId-apps-appId-sets-setId-resources.
      operations:
      - method: GET
        name: getsetresourceinputs
        description: Get Resource Inputs for the given Deployment Set
        call: humanitec-set.getsetresourceinputs
        with:
          setId: rest.setId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: humanitec-set-mcp
    port: 9090
    transport: http
    description: MCP adapter for Humanitec API — Set. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: get-all-deployment-sets
      description: Get all Deployment Sets
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: humanitec-set.listsets
      outputParameters:
      - type: object
        mapping: $.
    - name: get-deployment-set
      description: Get a Deployment Set
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: humanitec-set.getset
      with:
        setId: tools.setId
        diff: tools.diff
      outputParameters:
      - type: object
        mapping: $.
    - name: apply-deployment-delta-deployment-set
      description: Apply a Deployment Delta to a Deployment Set
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: humanitec-set.updateset
      with:
        setId: tools.setId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-difference-between-2-deployment
      description: Get the difference between 2 Deployment Sets
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: humanitec-set.getdiff
      with:
        setId: tools.setId
        sourceSetId: tools.sourceSetId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-resource-inputs-given-deployment
      description: Get Resource Inputs for the given Deployment Set
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: humanitec-set.getsetresourceinputs
      with:
        setId: tools.setId
      outputParameters:
      - type: object
        mapping: $.