Kinde Management API — Connections

naftiko: 1.0.0-alpha2
info:
  label: Kinde Management API — Connections
  description: 'Kinde Management API — Connections. Manages authentication connections (social providers,
    enterprise SSO, SAML, OIDC, email/password databases) and SCIM directories: list/create/get/delete
    connections, enable/disable connections per application, and provision SCIM directories on plans that
    support them. Self-contained Naftiko capability covering one Kinde business surface.'
  tags:
  - Kinde
  - Connections
  - SSO
  - SAML
  - OIDC
  - SCIM
  - Directories
  created: '2026-05-22'
  modified: '2026-05-22'
binds:
- namespace: env
  keys:
    KINDE_SUBDOMAIN: KINDE_SUBDOMAIN
    KINDE_ACCESS_TOKEN: KINDE_ACCESS_TOKEN
capability:
  consumes:
  - type: http
    namespace: kinde-connections
    baseUri: https://{KINDE_SUBDOMAIN}.kinde.com/api/v1
    description: Kinde Management API — Connections business capability. Self-contained, no shared references.
    resources:
    - name: connections
      path: /connections
      operations:
      - name: getConnections
        method: GET
        description: List authentication connections.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page_size
          in: query
          type: integer
      - name: createConnection
        method: POST
        description: Create a new authentication connection (e.g. Google, Microsoft, SAML, OIDC).
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    - name: connection
      path: /connections/{connection_id}
      operations:
      - name: getConnection
        method: GET
        description: Get a single connection by id.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: connection_id
          in: path
          type: string
          required: true
      - name: deleteConnection
        method: DELETE
        description: Delete an authentication connection.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: connection_id
          in: path
          type: string
          required: true
    - name: directories
      path: /directories
      operations:
      - name: getDirectories
        method: GET
        description: List SCIM directories provisioned in the business.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters: []
      - name: createDirectory
        method: POST
        description: Provision a new SCIM directory.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true