Sonatype Lifecycle Public REST API — Configure Artifactory Connection

naftiko: 1.0.0-alpha2
info:
  label: Sonatype Lifecycle Public REST API — Configure Artifactory Connection
  description: 'Sonatype Lifecycle Public REST API — Configure Artifactory Connection. 8 operations. Lead operation: Configure
    Artifactory Connection. Self-contained Naftiko capability covering one Sonatype business surface.'
  tags:
  - Sonatype
  - Configure Artifactory Connection
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    SONATYPE_API_KEY: SONATYPE_API_KEY
capability:
  consumes:
  - type: http
    namespace: lifecycle-configure-artifactory-connection
    baseUri: ''
    description: Sonatype Lifecycle Public REST API — Configure Artifactory Connection business capability. Self-contained,
      no shared references.
    resources:
    - name: api-v2-config-artifactoryConnection-ownerType-internalOwnerId
      path: /api/v2/config/artifactoryConnection/{ownerType}/{internalOwnerId}
      operations:
      - name: getownerartifactoryconnection
        method: GET
        description: Use this method to retrieve Artifactory connection details by specifying the owner Id.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ownerType
          in: path
          type: string
          description: Select the owner type.
          required: true
        - name: internalOwnerId
          in: path
          type: string
          description: Enter the internal ID of the owner.
          required: true
        - name: inherit
          in: query
          type: boolean
          description: Specify whether to include details from an inherited Artifactory connection.
      - name: addartifactoryconnection
        method: POST
        description: Use this method to add a new Artifactory connection.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ownerType
          in: path
          type: string
          description: Select the owner type.
          required: true
        - name: internalOwnerId
          in: path
          type: string
          description: Enter the internal ID of the owner.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: updateownerartifactoryconnectionstatus
        method: PUT
        description: Use this method to enable/disable an existing Artifactory connection for the specified owner.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ownerType
          in: path
          type: string
          description: Select the owner type.
          required: true
        - name: internalOwnerId
          in: path
          type: string
          description: Enter the internal ID of the owner.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v2-config-artifactoryConnection-ownerType-internalOwnerId-test
      path: /api/v2/config/artifactoryConnection/{ownerType}/{internalOwnerId}/test
      operations:
      - name: testartifactoryconnection
        method: POST
        description: Use this method to test an Artifactory connection for the specified owner.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ownerType
          in: path
          type: string
          description: Select the owner type.
          required: true
        - name: internalOwnerId
          in: path
          type: string
          description: Enter the internal ID of the owner.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v2-config-artifactoryConnection-ownerType-internalOwnerId-artifactoryConnect
      path: /api/v2/config/artifactoryConnection/{ownerType}/{internalOwnerId}/{artifactoryConnectionId}
      operations:
      - name: deleteartifactoryconnection
        method: DELETE
        description: Use this method to delete an existing Artifactory connection.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ownerType
          in: path
          type: string
          description: Select the owner type.
          required: true
        - name: internalOwnerId
          in: path
          type: string
          description: Enter the internal ID of the owner.
          required: true
        - name: artifactoryConnectionId
          in: path
          type: string
          description: Enter the Artifactory connection ID.
          required: true
      - name: getartifactoryconnection
        method: GET
        description: Use this method to retrieve details for an Artifactory connection.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ownerType
          in: path
          type: string
          description: Select the owner type.
          required: true
        - name: internalOwnerId
          in: path
          type: string
          description: Enter the internal ID of the owner.
          required: true
        - name: artifactoryConnectionId
          in: path
          type: string
          description: Enter the Artifactory connection ID.
          required: true
      - name: updateartifactoryconnection
        method: PUT
        description: Use this method to update an existing Artifactory connection.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ownerType
          in: path
          type: string
          description: Specify the owner type.
          required: true
        - name: internalOwnerId
          in: path
          type: string
          description: Enter the internal ID of the owner.
          required: true
        - name: artifactoryConnectionId
          in: path
          type: string
          description: Enter the Artifactory connection ID.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v2-config-artifactoryConnection-ownerType-internalOwnerId-artifactoryConnect
      path: /api/v2/config/artifactoryConnection/{ownerType}/{internalOwnerId}/{artifactoryConnectionId}/test
      operations:
      - name: testartifactoryconnection1
        method: POST
        description: Use this method to test an existing Artifactory connection using the connection ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ownerType
          in: path
          type: string
          description: Enter the owner type.
          required: true
        - name: internalOwnerId
          in: path
          type: string
          description: Enter the internal ID of the owner.
          required: true
        - name: artifactoryConnectionId
          in: path
          type: string
          description: Enter the Artifactory connection ID.
          required: true
    authentication:
      type: bearer
      token: '{{env.SONATYPE_API_KEY}}'
  exposes:
  - type: rest
    namespace: lifecycle-configure-artifactory-connection-rest
    port: 8080
    description: REST adapter for Sonatype Lifecycle Public REST API — Configure Artifactory Connection. One Spectral-compliant
      resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/api/v2/config/artifactoryconnection/{ownertype}/{internalownerid}
      name: api-v2-config-artifactoryconnection-ownertype-internalownerid
      description: REST surface for api-v2-config-artifactoryConnection-ownerType-internalOwnerId.
      operations:
      - method: GET
        name: getownerartifactoryconnection
        description: Use this method to retrieve Artifactory connection details by specifying the owner Id.
        call: lifecycle-configure-artifactory-connection.getownerartifactoryconnection
        with:
          ownerType: rest.ownerType
          internalOwnerId: rest.internalOwnerId
          inherit: rest.inherit
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: addartifactoryconnection
        description: Use this method to add a new Artifactory connection.
        call: lifecycle-configure-artifactory-connection.addartifactoryconnection
        with:
          ownerType: rest.ownerType
          internalOwnerId: rest.internalOwnerId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: updateownerartifactoryconnectionstatus
        description: Use this method to enable/disable an existing Artifactory connection for the specified owner.
        call: lifecycle-configure-artifactory-connection.updateownerartifactoryconnectionstatus
        with:
          ownerType: rest.ownerType
          internalOwnerId: rest.internalOwnerId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/config/artifactoryconnection/{ownertype}/{internalownerid}/test
      name: api-v2-config-artifactoryconnection-ownertype-internalownerid-test
      description: REST surface for api-v2-config-artifactoryConnection-ownerType-internalOwnerId-test.
      operations:
      - method: POST
        name: testartifactoryconnection
        description: Use this method to test an Artifactory connection for the specified owner.
        call: lifecycle-configure-artifactory-connection.testartifactoryconnection
        with:
          ownerType: rest.ownerType
          internalOwnerId: rest.internalOwnerId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/config/artifactoryconnection/{ownertype}/{internalownerid}/{artifactoryconnectionid}
      name: api-v2-config-artifactoryconnection-ownertype-internalownerid-artifactoryconnect
      description: REST surface for api-v2-config-artifactoryConnection-ownerType-internalOwnerId-artifactoryConnect.
      operations:
      - method: DELETE
        name: deleteartifactoryconnection
        description: Use this method to delete an existing Artifactory connection.
        call: lifecycle-configure-artifactory-connection.deleteartifactoryconnection
        with:
          ownerType: rest.ownerType
          internalOwnerId: rest.internalOwnerId
          artifactoryConnectionId: rest.artifactoryConnectionId
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getartifactoryconnection
        description: Use this method to retrieve details for an Artifactory connection.
        call: lifecycle-configure-artifactory-connection.getartifactoryconnection
        with:
          ownerType: rest.ownerType
          internalOwnerId: rest.internalOwnerId
          artifactoryConnectionId: rest.artifactoryConnectionId
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: updateartifactoryconnection
        description: Use this method to update an existing Artifactory connection.
        call: lifecycle-configure-artifactory-connection.updateartifactoryconnection
        with:
          ownerType: rest.ownerType
          internalOwnerId: rest.internalOwnerId
          artifactoryConnectionId: rest.artifactoryConnectionId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/config/artifactoryconnection/{ownertype}/{internalownerid}/{artifactoryconnectionid}/test
      name: api-v2-config-artifactoryconnection-ownertype-internalownerid-artifactoryconnect
      description: REST surface for api-v2-config-artifactoryConnection-ownerType-internalOwnerId-artifactoryConnect.
      operations:
      - method: POST
        name: testartifactoryconnection1
        description: Use this method to test an existing Artifactory connection using the connection ID.
        call: lifecycle-configure-artifactory-connection.testartifactoryconnection1
        with:
          ownerType: rest.ownerType
          internalOwnerId: rest.internalOwnerId
          artifactoryConnectionId: rest.artifactoryConnectionId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: lifecycle-configure-artifactory-connection-mcp
    port: 9090
    transport: http
    description: MCP adapter for Sonatype Lifecycle Public REST API — Configure Artifactory Connection. One tool per consumed
      operation, routed inline through this capability's consumes block.
    tools:
    - name: use-this-method-retrieve-artifactory
      description: Use this method to retrieve Artifactory connection details by specifying the owner Id.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lifecycle-configure-artifactory-connection.getownerartifactoryconnection
      with:
        ownerType: tools.ownerType
        internalOwnerId: tools.internalOwnerId
        inherit: tools.inherit
      outputParameters:
      - type: object
        mapping: $.
    - name: use-this-method-add-new
      description: Use this method to add a new Artifactory connection.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: lifecycle-configure-artifactory-connection.addartifactoryconnection
      with:
        ownerType: tools.ownerType
        internalOwnerId: tools.internalOwnerId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: use-this-method-enable-disable
      description: Use this method to enable/disable an existing Artifactory connection for the specified owner.
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: lifecycle-configure-artifactory-connection.updateownerartifactoryconnectionstatus
      with:
        ownerType: tools.ownerType
        internalOwnerId: tools.internalOwnerId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: use-this-method-test-artifactory
      description: Use this method to test an Artifactory connection for the specified owner.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: lifecycle-configure-artifactory-connection.testartifactoryconnection
      with:
        ownerType: tools.ownerType
        internalOwnerId: tools.internalOwnerId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: use-this-method-delete-existing
      description: Use this method to delete an existing Artifactory connection.
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: lifecycle-configure-artifactory-connection.deleteartifactoryconnection
      with:
        ownerType: tools.ownerType
        internalOwnerId: tools.internalOwnerId
        artifactoryConnectionId: tools.artifactoryConnectionId
      outputParameters:
      - type: object
        mapping: $.
    - name: use-this-method-retrieve-details
      description: Use this method to retrieve details for an Artifactory connection.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lifecycle-configure-artifactory-connection.getartifactoryconnection
      with:
        ownerType: tools.ownerType
        internalOwnerId: tools.internalOwnerId
        artifactoryConnectionId: tools.artifactoryConnectionId
      outputParameters:
      - type: object
        mapping: $.
    - name: use-this-method-update-existing
      description: Use this method to update an existing Artifactory connection.
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: lifecycle-configure-artifactory-connection.updateartifactoryconnection
      with:
        ownerType: tools.ownerType
        internalOwnerId: tools.internalOwnerId
        artifactoryConnectionId: tools.artifactoryConnectionId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: use-this-method-test-existing
      description: Use this method to test an existing Artifactory connection using the connection ID.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: lifecycle-configure-artifactory-connection.testartifactoryconnection1
      with:
        ownerType: tools.ownerType
        internalOwnerId: tools.internalOwnerId
        artifactoryConnectionId: tools.artifactoryConnectionId
      outputParameters:
      - type: object
        mapping: $.