{"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.","lastUpdated":"2026-04-22","sections":[{"id":"contract-boundary","title":"Contract Boundary","content":"This documentation covers the stable external integration contract only. Platform internals, administrative routes, schema-level discovery, and partner-only capabilities are intentionally withheld from the public surface.\n\nDetailed public topics are limited to identity and app registration, oauth and service tokens, jwks and token verification, event delivery and webhooks, graphql transport contract.\nAdvanced platform capabilities stay behind the vendor integration request flow and are not published as machine-readable docs.","codeExamples":[]},{"id":"base-urls","title":"Base URLs","content":"Website documentation: https://knogin.com/docs/api-reference\nMachine-readable index: https://knogin.com/api/docs\nAuthentication service: https://auth.knogin.com\nGraphQL transport: https://api.knogin.com/graphql","codeExamples":[]},{"id":"quick-start","title":"Quick Start","content":"1. Create or inspect your integration app under /v1/platform/apps.\n2. Confirm the scopes your tenant has approved with /v1/platform/scopes.\n3. Obtain OAuth access tokens or mint service tokens for machine-to-machine flows.\n4. Validate JWTs against the public JWKS endpoints.\n5. Configure webhooks or request access for advanced platform capabilities.","codeExamples":[{"language":"bash","code":"curl https://knogin.com/api/docs | jq .\n\ncurl https://knogin.com/api/docs/oauth-service-tokens\n\ncurl https://knogin.com/api/docs?format=markdown","description":"Machine-readable discovery"}]},{"id":"request-access","title":"Capabilities Available By Request","content":"Advanced platform APIs, curated GraphQL bundles, and enterprise federation are intentionally excluded from machine-readable public docs.\nPartner bundle version: 2026.2.\nApproved partners receive the curated GraphQL bundle at /partners/contract/v2026.2/external.graphql and the REST bundle at /partners/contract/v2026.2/external-openapi.json.\nSDK families pinned to this contract: @argus/connector-sdk@2026.2.0, argus-connector-sdk@2026.2.0, @argus/client@2026.2.0, argus-client@2026.2.0.\nRequest access through https://knogin.com/docs/integration-guide#vendor-contact when your integration requires a reviewed partner or customer-admin workflow.","codeExamples":[]}],"relatedTopics":["identity-app-registration","oauth-service-tokens","jwks-token-verification","event-delivery-webhooks","graphql-transport-contract"],"markdown":"# Knogin External Integration API\n\nStable public integration documentation for external integrators. This surface covers app registration, OAuth, JWKS verification, webhooks, and GraphQL transport only.\n\n## Contract Boundary\n\nThis documentation covers the stable external integration contract only. Platform internals, administrative routes, schema-level discovery, and partner-only capabilities are intentionally withheld from the public surface.\n\nDetailed public topics are limited to identity and app registration, oauth and service tokens, jwks and token verification, event delivery and webhooks, graphql transport contract.\nAdvanced platform capabilities stay behind the vendor integration request flow and are not published as machine-readable docs.\n\n## Base URLs\n\nWebsite documentation: https://knogin.com/docs/api-reference\nMachine-readable index: https://knogin.com/api/docs\nAuthentication service: https://auth.knogin.com\nGraphQL transport: https://api.knogin.com/graphql\n\n## Quick Start\n\n1. Create or inspect your integration app under /v1/platform/apps.\n2. Confirm the scopes your tenant has approved with /v1/platform/scopes.\n3. Obtain OAuth access tokens or mint service tokens for machine-to-machine flows.\n4. Validate JWTs against the public JWKS endpoints.\n5. Configure webhooks or request access for advanced platform capabilities.\n\nMachine-readable discovery\n\n```bash\ncurl https://knogin.com/api/docs | jq .\n\ncurl https://knogin.com/api/docs/oauth-service-tokens\n\ncurl https://knogin.com/api/docs?format=markdown\n```\n\n## Capabilities Available By Request\n\nAdvanced platform APIs, curated GraphQL bundles, and enterprise federation are intentionally excluded from machine-readable public docs.\nPartner bundle version: 2026.2.\nApproved partners receive the curated GraphQL bundle at /partners/contract/v2026.2/external.graphql and the REST bundle at /partners/contract/v2026.2/external-openapi.json.\nSDK families pinned to this contract: @argus/connector-sdk@2026.2.0, argus-connector-sdk@2026.2.0, @argus/client@2026.2.0, argus-client@2026.2.0.\nRequest access through https://knogin.com/docs/integration-guide#vendor-contact when your integration requires a reviewed partner or customer-admin workflow.\n\n## Related Topics\n\n- [Identity and app registration](https://knogin.com/api/docs/identity-app-registration)\n- [OAuth and service tokens](https://knogin.com/api/docs/oauth-service-tokens)\n- [JWKS and token verification](https://knogin.com/api/docs/jwks-token-verification)\n- [Event delivery and webhooks](https://knogin.com/api/docs/event-delivery-webhooks)\n- [GraphQL transport contract](https://knogin.com/api/docs/graphql-transport-contract)","metadata":{"readingTime":"8 min","difficulty":"intermediate","tags":["integrations","api","oauth","webhooks","graphql"]}}