Authentication

Register an account

Create an account and its first user when public registration is enabled.

POST/api/v1/auth/register

Authentication: no bearer token is required.

Parameters

account_namestringrequired

BodyThe workspace or account name.

namestringrequired

BodyThe user's display name.

emailemailrequired

BodyThe user's email address.

passwordstringrequired

BodyA password containing at least 8 characters.

Responses

201

The account was created. A verification step may be required before login.

400

The request is invalid or contains an unsupported value.

403

The account plan or current grant does not allow the action.

cURL

curl --fail-with-body --request POST \
  --url "https://api.sitedropper.com/api/v1/auth/register" \
  --header "Content-Type: application/json" \
  --data '{
  "account_name": "Acme Studio",
  "name": "Alex Builder",
  "email": "[email protected]",
  "password": "correct-horse-battery-staple"
}'

Response · 201

{
  "user": {
    "id": "e6f56c4b-f13d-43aa-a495-486b2155fba1",
    "email": "[email protected]",
    "name": "Alex Builder"
  },
  "status": "pending_verification",
  "email_verification_required": true
}