Skip to content

Register company in tenant_registry (portal, owner-only)

POST
/api/account/company
 
curl --request POST \
  --url http://localhost:3000/api/account/company \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "slug": "example" }'

Cloud only. Bearer JWT + X-Organization-Id. Membership must be owner. Body is { name, slug } only — never tenant_id. Upserts public.tenant_registry.

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
Media type application/json
object
name
required
string
>= 1 characters <= 200 characters
slug
required
string
>= 1 characters <= 48 characters /^[a-z0-9]+(?:-[a-z0-9]+)*$/
Example generated
{
  "name": "example",
  "slug": "example"
}

Responses

Section titled “ Responses ”

201

Section titled “201 ”

Company registered

400

Section titled “400 ”

Invalid body or no active organisation

Media type application/json
object
error
required
string
Example 
{
  "error": "Not found"
}

401

Section titled “401 ”

Not authenticated

Media type application/json
object
error
required
string
Example 
{
  "error": "Not found"
}

403

Section titled “403 ”

Owner role required

Media type application/json
object
error
required
string
Example 
{
  "error": "Not found"
}

409

Section titled “409 ”

Slug taken

Media type application/json
object
error
required
string
Example 
{
  "error": "Not found"
}