Quickstart

This page walks through hitting the Slothbox API for the first time — creating an API key, calling /me, and creating an organization.

1. Get an API key

API keys are created from the web app (Settings → API keys) and shown once. Copy it somewhere safe.

Programmatic creation is possible too, but minting a key requires a Cognito session — an existing API key can't mint more keys. See Authentication for why.

2. Verify the key

curl https://api.aws.slothbox.dev/me \
  -H "Authorization: sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

You should get back a JSON document with your user and the organizations you belong to.

3. Create an organization

curl https://api.aws.slothbox.dev/organizations \
  -H "Authorization: sk_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme"}'

The caller automatically becomes the first owner. From here you can invite teammates, connect an AWS account, and start defining environments. The full set of endpoints lives in the API reference.