developers

Build on headstreamer.

A REST API for your brains and the company intelligence layer, SCIM for provisioning, and SAML/OIDC for SSO.

Authentication

Create an API key in Settings → SSO & API. Send it as a bearer token:

curl https://headstreamer.com/api/v1/org \
  -H "Authorization: Bearer hs_your_key"

REST API (v1)

GET /api/v1/org	Your organization.
GET /api/v1/members	Members of the org.
GET /api/v1/brains/:user/projects	A member's projects you can access.
GET /api/v1/brains/:user/projects/:slug	A project with its documents.
GET /api/v1/intelligence	The company knowledge-graph documents.

SCIM 2.0 provisioning

Point your IdP (Okta, Azure AD, Google) at https://headstreamer.com/scim/v2 with the SCIM bearer token from Settings. Supports Users create / list / deactivate.

Single sign-on

Google Workspace (OIDC) and SAML 2.0 are supported. Configure SAML in Settings → SSO & API; the SP metadata is at https://headstreamer.com/saml/<org>/metadata, ACS at https://headstreamer.com/auth/saml/callback.

Status

Machine-readable health at /api/status; public status page at /status.