Bootstrap tenant

Creates a new tenant and returns a master API key. Protected by X-Setup-Token header.

POST /v1/setup

Bootstrap tenant

cURL

curl --request POST \
  --url http://localhost:8080/v1/setup \
  --header 'Content-Type: application/json' \
  --header 'X-Setup-Token: <x-setup-token>' \
  --data '
{
  "org_name": "My Company"
}
'

201

{
  "tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "api_key": "mk_a1b2c3d4...",
  "message": "<string>"
}

Headers

X-Setup-Token · string · required

Body

application/json

org_name · string · required

Example:

"My Company"

Response

201 - application/json

Tenant created

tenant_id · string<uuid>

api_key · string

Example:

"mk_a1b2c3d4..."

message · string