{"version":"2026.1","lastUpdated":"2026-03-23","description":"Knogin external integration documentation for app registration, OAuth, JWKS verification, webhook delivery, and GraphQL transport.","baseUrl":"https://knogin.com","endpoints":{"index":"https://knogin.com/api/docs","fullMarkdown":"https://knogin.com/api/docs?format=markdown","topic":"https://knogin.com/api/docs/{topic}","llmsTxt":"https://knogin.com/llms.txt"},"topics":[{"id":"api-reference","title":"Knogin External Integration API","description":"Stable public integration documentation for external integrators. This surface covers app registration, OAuth, JWKS verification, webhooks, and GraphQL transport only.","url":"https://knogin.com/api/docs/api-reference","sections":["Contract Boundary","Base URLs","Quick Start","Capabilities Available By Request"],"lastUpdated":"2026-03-23"},{"id":"identity-app-registration","title":"Identity and app registration","description":"Register an integration, inspect allowed scopes, and manage governance settings for an external app.","url":"https://knogin.com/api/docs/identity-app-registration","sections":["GET /v1/platform/scopes · List available scopes","GET/POST /v1/platform/apps · Create and list platform apps","GET /v1/platform/apps/{client_id} · Inspect an integration app","PATCH /v1/platform/apps/{client_id}/governance · Update app governance"],"lastUpdated":"2026-03-23"},{"id":"oauth-service-tokens","title":"OAuth and service tokens","description":"Use OAuth 2.0 authorization code or client credentials flows, then rotate credentials without exposing internal auth flows.","url":"https://knogin.com/api/docs/oauth-service-tokens","sections":["GET /v1/oauth/authorize · Start OAuth authorization code flow","POST /v1/oauth/token · Exchange or mint access tokens","POST /v1/platform/apps/{client_id}/service-token · Mint a service token","POST /v1/platform/apps/{client_id}/rotate-secret · Rotate an app secret"],"lastUpdated":"2026-03-23"},{"id":"jwks-token-verification","title":"JWKS and token verification","description":"Verify Knogin-issued JWTs against public JWKS endpoints rather than relying on private signing details.","url":"https://knogin.com/api/docs/jwks-token-verification","sections":["GET /.well-known/jwks.json · OpenID-compatible JWKS discovery","GET /v1/auth/jwks.json · Versioned JWKS endpoint"],"lastUpdated":"2026-03-23"},{"id":"event-delivery-webhooks","title":"Event delivery and webhooks","description":"Create, test, and observe webhook deliveries for approved outbound integrations.","url":"https://knogin.com/api/docs/event-delivery-webhooks","sections":["GET/POST /v1/webhooks · Create and list webhooks","GET/PUT/DELETE /v1/webhooks/{webhook_id} · Inspect, update, or delete a webhook","GET /v1/webhooks/{webhook_id}/deliveries · Review delivery attempts","POST /v1/webhooks/{webhook_id}/test · Send a test webhook"],"lastUpdated":"2026-03-23"},{"id":"graphql-transport-contract","title":"GraphQL transport contract","description":"Connect to the shared GraphQL transport with bearer authentication and tenant scoping, without publishing the full schema or operation inventory.","url":"https://knogin.com/api/docs/graphql-transport-contract","sections":["POST /graphql · Use the shared GraphQL transport"],"lastUpdated":"2026-03-23"}],"quickStart":{"steps":["Register an external app with the auth service.","Request only approved scopes for your tenant.","Obtain OAuth or service tokens for your workflow.","Verify JWTs against the public JWKS endpoints.","Use webhooks or request access for advanced platform capabilities."],"cliInstall":""},"partnerPortal":{"contractVersion":"2026.1","requestAccessUrl":"https://knogin.com/en/docs/integration-guide#vendor-contact","graphqlBundle":{"path":"/partners/contract/v2026.1/external.graphql","availability":"approved_partner"},"openapiBundle":{"path":"/partners/contract/v2026.1/external-openapi.json","availability":"approved_partner"},"sdkPackages":[{"name":"@argus/connector-sdk","language":"typescript","version":"2026.1.0","availability":"approved_partner"},{"name":"argus-connector-sdk","language":"python","version":"2026.1.0","availability":"approved_partner"},{"name":"@argus/client","language":"typescript","version":"2026.1.0","availability":"approved_partner"},{"name":"argus-client","language":"python","version":"2026.1.0","availability":"approved_partner"}]}}