Cairn developer documentation

Build on the API behind Cairn — capture, guides, knowledge, conversations and the AI agent.

API reference Every operation and schema, generated from the same OpenAPI contract CI holds the server to. Raw OpenAPI document Fetch /openapi.yaml for your own tooling and client generation.

Guides

Widget installation install, allowed hosts, SPA navigation and logout Verified identity HMAC and JWT, signing, limits and rotation Content Security Policy scripts, realtime, images and current style limitations Help-center sign-in authenticate readers through your own application Experiences author, target, publish and pick elements Laravel and Bagisto customer, seller and admin integration Widget JS API embed, identify, and the ≤120KB budget Webhooks events, signing, retries API changelog deprecations and their sunset dates Cairn Desktop recording any app, privacy, and what to do when something goes wrong Cairn Desktop releases what changed in each version

Identity & SSO

Cairn supports SAML SSO and SCIM provisioning on Enterprise plans; the SCIM service-provider configuration endpoint describes exactly what the directory integration supports.

curl "$CAIRN_BASE_URL/api/v1/workspaces/$WORKSPACE/guides" \
  -H "Authorization: Bearer $CAIRN_TOKEN" \
  -H "X-Workspace-Id: $WORKSPACE"