Quickstart

Getting started

Kemble’s API is REST over HTTPS with JSON bodies. Authentication is a bearer token issued at sign-in. Every request is scoped to one organization, resolved from the token — there is no organization parameter to get wrong.

Sign in

curl -X POST https://kemble.io/api/auth/login \
  -H 'content-type: application/json' \
  -d '{"email":"you@example.com","password":"..."}'

The response carries a token. Send it as an Authorization header on everything that follows.

Find where to post

curl https://kemble.io/api/spaces -H "authorization: Bearer $TOKEN"
curl https://kemble.io/api/spaces/$SPACE/channels -H "authorization: Bearer $TOKEN"

Post

curl -X POST https://kemble.io/api/channels/$CHANNEL/messages \
  -H "authorization: Bearer $TOKEN" \
  -H 'content-type: application/json' \
  -d '{"content":"Hello from the API"}'