Knak · OpenAPI Overlay 1.0.0

API Evangelist enhancements for the Knak SCIM API

1 action 1 update update extends openapi/knak-scim-openapi-original.yml

Generated by API Evangelist Written by API Evangelist tooling for Knak's API. It is a proposal applied on top of the contract, not a document Knak publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-artifactsx-apievangelist-observations

Targets 1

$.info

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for the Knak SCIM API
  version: 1.0.0
extends: openapi/knak-scim-openapi-original.yml
x-generated: '2026-07-19'
x-method: generated
x-source: API Evangelist enrichment pipeline
x-notes: >-
  Records how the Knak SCIM surface relates to the Enterprise user endpoints and where the
  specification is thinner than the SCIM 2.0 standard it implements.
actions:
- target: $.info
  update:
    x-apievangelist-artifacts:
      authentication: authentication/knak-authentication.yml
      conformance: conformance/knak-conformance.yml
      data-model: data-model/knak-data-model.yml
      skills: skills/knak-provision-users-scim.md
    x-apievangelist-observations:
    - Implements SCIM 2.0 at https://enterprise.knak.io/scim/v2 with a /Users resource
      supporting GET, POST, PUT and PATCH. No /Groups resource is published.
    - No operationId is declared on any operation.
    - No securitySchemes are declared, although provisioning requests require a bearer
      token issued in Knak Enterprise.
    - The same users are also readable and deletable through the Enterprise API /users
      endpoints; deletion is available there rather than through SCIM.
    - Single sign-on is delivered over SAML 2.0 rather than OpenID Connect.