latestOpenAPI 3.1.0Proprietary2026-08-1095216168.4 KB

db81a447bba9

Account

Sign up

Create a new user account from a verified IdP intent. Optionally provisions a tenant + division (e.g. for SaaS onboarding) or accepts an invitation token. If the IdP-provided email matches an existing tenant's claimed email domain and join_policy allows, the new user joins automatically and a session is returned. Otherwise the account is created in awaiting_verification state.

post/account/sign_up

Request body

feedbackstring nullable
idstring required
invitationstring nullable
namestring required
source'google' | 'github' | 'microsoft' required
tenantstring
titlestring required
tokenstring required

Example request

{
  "name": "Alice Doe",
  "tenant": "acme-corp",
  "title": "Backend Engineer"
}

Response

Account created. If verified and tenant resolved, includes session + ld-tenant / ld-division response headers

division_idinteger
division_namestring
linked_accountsIdentityProvider[] nullable
tenant_idinteger
tenant_namestring
verifiedboolean required
workspace'joined' | 'join_requested' | 'awaiting_invitation'

Example response

{
  "division_id": 7261844974723780000,
  "division_name": "production",
  "session": {
    "email": "alice@laserdata.com"
  },
  "tenant_id": 7261845022003200000,
  "tenant_name": "acme-corp"
}