OpenStorage SDK — OpenStorageIdentity

naftiko: 1.0.0-alpha2
info:
  label: OpenStorage SDK — OpenStorageIdentity
  description: 'OpenStorage SDK — OpenStorageIdentity. 2 operations. Lead operation: Capabilities returns the supported services
    by the cluster.

    This allows SDK implementations to advertise their supported

    services as the API matures. With this information, clients

    can determine supported services from storage clusters at

    different versions.. Self-contained Naftiko capability covering one Portworx business surfac'
  tags:
  - Portworx
  - OpenStorageIdentity
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    PORTWORX_API_KEY: PORTWORX_API_KEY
capability:
  consumes:
  - type: http
    namespace: portworx-openstorageidentity
    baseUri: ''
    description: OpenStorage SDK — OpenStorageIdentity business capability. Self-contained, no shared references.
    resources:
    - name: v1-identities-capabilities
      path: /v1/identities/capabilities
      operations:
      - name: openstorageidentitycapabilities
        method: GET
        description: Capabilities returns the supported services by the cluster.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-identities-version
      path: /v1/identities/version
      operations:
      - name: openstorageidentityversion
        method: GET
        description: Version returns version information about the system.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      token: '{{env.PORTWORX_API_KEY}}'
  exposes:
  - type: rest
    namespace: portworx-openstorageidentity-rest
    port: 8080
    description: REST adapter for OpenStorage SDK — OpenStorageIdentity. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/v1/identities/capabilities
      name: v1-identities-capabilities
      description: REST surface for v1-identities-capabilities.
      operations:
      - method: GET
        name: openstorageidentitycapabilities
        description: Capabilities returns the supported services by the cluster.
        call: portworx-openstorageidentity.openstorageidentitycapabilities
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/identities/version
      name: v1-identities-version
      description: REST surface for v1-identities-version.
      operations:
      - method: GET
        name: openstorageidentityversion
        description: Version returns version information about the system.
        call: portworx-openstorageidentity.openstorageidentityversion
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: portworx-openstorageidentity-mcp
    port: 9090
    transport: http
    description: MCP adapter for OpenStorage SDK — OpenStorageIdentity. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: capabilities-returns-supported-services-cluster
      description: Capabilities returns the supported services by the cluster.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: portworx-openstorageidentity.openstorageidentitycapabilities
      outputParameters:
      - type: object
        mapping: $.
    - name: version-returns-version-information-about
      description: Version returns version information about the system.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: portworx-openstorageidentity.openstorageidentityversion
      outputParameters:
      - type: object
        mapping: $.