Konnect API - Go SDK — Auth Settings

naftiko: 1.0.0-alpha2
info:
  label: Konnect API - Go SDK — Auth Settings
  description: 'Konnect API - Go SDK — Auth Settings. 17 operations. Lead operation: Get Auth Settings. Self-contained Naftiko
    capability covering one Kong business surface.'
  tags:
  - Kong
  - Auth Settings
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    KONG_API_KEY: KONG_API_KEY
capability:
  consumes:
  - type: http
    namespace: konnect-platform-auth-settings
    baseUri: https://global.api.konghq.com
    description: Konnect API - Go SDK — Auth Settings business capability. Self-contained, no shared references.
    resources:
    - name: v3-authentication-settings
      path: /v3/authentication-settings
      operations:
      - name: getauthenticationsettings
        method: GET
        description: Get Auth Settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateauthenticationsettings
        method: PATCH
        description: Update Auth Settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v3-identity-provider
      path: /v3/identity-provider
      operations:
      - name: getidpconfiguration
        method: GET
        description: Get the IdP Configuration
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateidpconfiguration
        method: PATCH
        description: Update IdP Configuration
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v3-identity-provider-team-group-mappings
      path: /v3/identity-provider/team-group-mappings
      operations:
      - name: getteamgroupmappings
        method: GET
        description: Get a Team Group Mappings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: patchteamgroupmappings
        method: PATCH
        description: Patch Mappings by Team ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v3-identity-provider-team-mappings
      path: /v3/identity-provider/team-mappings
      operations:
      - name: updateidpteammappings
        method: PUT
        description: Update Team Mappings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: getidpteammappings
        method: GET
        description: Get a Team Mapping
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v3-identity-providers
      path: /v3/identity-providers
      operations:
      - name: getidentityproviders
        method: GET
        description: List Identity Providers
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: filter
          in: query
          type: object
          description: Filter identity providers returned in the response.
      - name: createidentityprovider
        method: POST
        description: Create Identity Provider
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v3-identity-providers-idpId-team-group-mappings
      path: /v3/identity-providers/{idpId}/team-group-mappings
      operations:
      - name: listidpteamgroupmappings
        method: GET
        description: List Team Group Mappings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: filter
          in: query
          type: object
          description: Filter mappings by team ID or group name.
      - name: createidpteamgroupmapping
        method: POST
        description: Create Team Group Mapping
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v3-identity-providers-idpId-team-group-mappings-id
      path: /v3/identity-providers/{idpId}/team-group-mappings/{id}
      operations:
      - name: getidpteamgroupmapping
        method: GET
        description: Get Team Group Mapping
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteidpteamgroupmapping
        method: DELETE
        description: Delete Team Group Mapping
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v3-identity-providers-id
      path: /v3/identity-providers/{id}
      operations:
      - name: getidentityprovider
        method: GET
        description: Get Identity Provider
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateidentityprovider
        method: PATCH
        description: Update Identity Provider
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: deleteidentityprovider
        method: DELETE
        description: Delete Identity Provider
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      token: '{{env.KONG_API_KEY}}'
  exposes:
  - type: rest
    namespace: konnect-platform-auth-settings-rest
    port: 8080
    description: REST adapter for Konnect API - Go SDK — Auth Settings. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/v3/authentication-settings
      name: v3-authentication-settings
      description: REST surface for v3-authentication-settings.
      operations:
      - method: GET
        name: getauthenticationsettings
        description: Get Auth Settings
        call: konnect-platform-auth-settings.getauthenticationsettings
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: updateauthenticationsettings
        description: Update Auth Settings
        call: konnect-platform-auth-settings.updateauthenticationsettings
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/identity-provider
      name: v3-identity-provider
      description: REST surface for v3-identity-provider.
      operations:
      - method: GET
        name: getidpconfiguration
        description: Get the IdP Configuration
        call: konnect-platform-auth-settings.getidpconfiguration
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: updateidpconfiguration
        description: Update IdP Configuration
        call: konnect-platform-auth-settings.updateidpconfiguration
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/identity-provider/team-group-mappings
      name: v3-identity-provider-team-group-mappings
      description: REST surface for v3-identity-provider-team-group-mappings.
      operations:
      - method: GET
        name: getteamgroupmappings
        description: Get a Team Group Mappings
        call: konnect-platform-auth-settings.getteamgroupmappings
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: patchteamgroupmappings
        description: Patch Mappings by Team ID
        call: konnect-platform-auth-settings.patchteamgroupmappings
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/identity-provider/team-mappings
      name: v3-identity-provider-team-mappings
      description: REST surface for v3-identity-provider-team-mappings.
      operations:
      - method: PUT
        name: updateidpteammappings
        description: Update Team Mappings
        call: konnect-platform-auth-settings.updateidpteammappings
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getidpteammappings
        description: Get a Team Mapping
        call: konnect-platform-auth-settings.getidpteammappings
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/identity-providers
      name: v3-identity-providers
      description: REST surface for v3-identity-providers.
      operations:
      - method: GET
        name: getidentityproviders
        description: List Identity Providers
        call: konnect-platform-auth-settings.getidentityproviders
        with:
          filter: rest.filter
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createidentityprovider
        description: Create Identity Provider
        call: konnect-platform-auth-settings.createidentityprovider
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/identity-providers/{idpid}/team-group-mappings
      name: v3-identity-providers-idpid-team-group-mappings
      description: REST surface for v3-identity-providers-idpId-team-group-mappings.
      operations:
      - method: GET
        name: listidpteamgroupmappings
        description: List Team Group Mappings
        call: konnect-platform-auth-settings.listidpteamgroupmappings
        with:
          filter: rest.filter
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createidpteamgroupmapping
        description: Create Team Group Mapping
        call: konnect-platform-auth-settings.createidpteamgroupmapping
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/identity-providers/{idpid}/team-group-mappings/{id}
      name: v3-identity-providers-idpid-team-group-mappings-id
      description: REST surface for v3-identity-providers-idpId-team-group-mappings-id.
      operations:
      - method: GET
        name: getidpteamgroupmapping
        description: Get Team Group Mapping
        call: konnect-platform-auth-settings.getidpteamgroupmapping
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteidpteamgroupmapping
        description: Delete Team Group Mapping
        call: konnect-platform-auth-settings.deleteidpteamgroupmapping
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/identity-providers/{id}
      name: v3-identity-providers-id
      description: REST surface for v3-identity-providers-id.
      operations:
      - method: GET
        name: getidentityprovider
        description: Get Identity Provider
        call: konnect-platform-auth-settings.getidentityprovider
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: updateidentityprovider
        description: Update Identity Provider
        call: konnect-platform-auth-settings.updateidentityprovider
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteidentityprovider
        description: Delete Identity Provider
        call: konnect-platform-auth-settings.deleteidentityprovider
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: konnect-platform-auth-settings-mcp
    port: 9090
    transport: http
    description: MCP adapter for Konnect API - Go SDK — Auth Settings. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: get-auth-settings
      description: Get Auth Settings
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-auth-settings.getauthenticationsettings
      outputParameters:
      - type: object
        mapping: $.
    - name: update-auth-settings
      description: Update Auth Settings
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: konnect-platform-auth-settings.updateauthenticationsettings
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-idp-configuration
      description: Get the IdP Configuration
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-auth-settings.getidpconfiguration
      outputParameters:
      - type: object
        mapping: $.
    - name: update-idp-configuration
      description: Update IdP Configuration
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: konnect-platform-auth-settings.updateidpconfiguration
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-team-group-mappings
      description: Get a Team Group Mappings
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-auth-settings.getteamgroupmappings
      outputParameters:
      - type: object
        mapping: $.
    - name: patch-mappings-team-id
      description: Patch Mappings by Team ID
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: konnect-platform-auth-settings.patchteamgroupmappings
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: update-team-mappings
      description: Update Team Mappings
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: konnect-platform-auth-settings.updateidpteammappings
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-team-mapping
      description: Get a Team Mapping
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-auth-settings.getidpteammappings
      outputParameters:
      - type: object
        mapping: $.
    - name: list-identity-providers
      description: List Identity Providers
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-auth-settings.getidentityproviders
      with:
        filter: tools.filter
      outputParameters:
      - type: object
        mapping: $.
    - name: create-identity-provider
      description: Create Identity Provider
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: konnect-platform-auth-settings.createidentityprovider
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: list-team-group-mappings
      description: List Team Group Mappings
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-auth-settings.listidpteamgroupmappings
      with:
        filter: tools.filter
      outputParameters:
      - type: object
        mapping: $.
    - name: create-team-group-mapping
      description: Create Team Group Mapping
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: konnect-platform-auth-settings.createidpteamgroupmapping
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-team-group-mapping
      description: Get Team Group Mapping
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-auth-settings.getidpteamgroupmapping
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-team-group-mapping
      description: Delete Team Group Mapping
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: konnect-platform-auth-settings.deleteidpteamgroupmapping
      outputParameters:
      - type: object
        mapping: $.
    - name: get-identity-provider
      description: Get Identity Provider
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-auth-settings.getidentityprovider
      outputParameters:
      - type: object
        mapping: $.
    - name: update-identity-provider
      description: Update Identity Provider
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: konnect-platform-auth-settings.updateidentityprovider
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-identity-provider
      description: Delete Identity Provider
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: konnect-platform-auth-settings.deleteidentityprovider
      outputParameters:
      - type: object
        mapping: $.