Quickstart

There’s no dashboard yet, so these steps use curl. Creating a key requires a login session, which curl keeps in a cookie file.

curl -X POST https://api.vocalistic.ai/v1/auth/signup \
  -H 'Content-Type: application/json' \
  -d '{"email": "you@example.com", "password": "at-least-12-characters", "name": "Ada", "organization_name": "Acme"}'

We email you a verification link. Copy the value after token= in that link.

Verify your email

curl -X POST https://api.vocalistic.ai/v1/auth/verify-email \
  -H 'Content-Type: application/json' \
  -d '{"token": "TOKEN_FROM_THE_EMAIL"}'

curl -c cookies.txt -X POST https://api.vocalistic.ai/v1/auth/login \
  -H 'Content-Type: application/json' \
  -d '{"email": "you@example.com", "password": "at-least-12-characters"}'

curl -b cookies.txt -c cookies.txt https://api.vocalistic.ai/v1/auth/csrf

The second call returns a csrf_token. Keep it for the next step.

Create an API key

curl -b cookies.txt -X POST https://api.vocalistic.ai/v1/api-keys \
  -H 'Content-Type: application/json' \
  -H 'Referer: https://api.vocalistic.ai/' \
  -H 'X-CSRFToken: YOUR_CSRF_TOKEN' \
  -d '{"name": "My first key", "scopes": ["organization:read", "members:read"]}'

The response includes the key once, in the key field. Store it somewhere safe, because we can’t show it again.

Make your first call

curl https://api.vocalistic.ai/v1/whoami \
  -H 'Authorization: Bearer YOUR_API_KEY'

The response shows your organization and what the key can do.

Get started

API reference