Onboarding
Provision the signed-in user's workspace
Authorization
bearerClerk Clerk session JWT from an authenticated dashboard user. Format: Bearer eyJ....
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
curl -X POST "https://loading/api/v1/onboarding/bootstrap" \ -H "Content-Type: application/json" \ -d '{}'{
"$schema": "/api/v1/schemas/BootstrapResult.json",
"clerk_org_id": "string",
"created": true,
"domain_created": true,
"slug": "string",
"tenant_id": "string",
"workspace_url": "string"
}{
"$schema": "/api/v1/schemas/ErrorModel.json",
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "string",
"message": "string",
"value": null
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Claim a trial tenant into your account
Authorization
bearerClerk Clerk session JWT from an authenticated dashboard user. Format: Bearer eyJ....
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
The claim token from the claim link
Response Body
application/json
application/problem+json
curl -X POST "https://loading/api/v1/onboarding/claim" \ -H "Content-Type: application/json" \ -d '{ "claim_token": "string" }'{
"$schema": "/api/v1/schemas/ClaimResult.json",
"agent_id": "string",
"agent_name": "string",
"clerk_org_id": "string",
"status": "string",
"tenant_id": "string"
}{
"$schema": "/api/v1/schemas/ErrorModel.json",
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "string",
"message": "string",
"value": null
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Get a claim link for the caller's trial tenant
Authorization
apiKey API key issued to a Sonzai project. Format: Bearer sk_....
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
curl -X POST "https://loading/api/v1/onboarding/claim-link" \ -H "Content-Type: application/json" \ -d '{}'{
"$schema": "/api/v1/schemas/ClaimLinkOutputBody.json",
"claim_url": "string",
"expires_at": "string"
}{
"$schema": "/api/v1/schemas/ErrorModel.json",
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "string",
"message": "string",
"value": null
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Get the caller's preferred organization
Authorization
bearerClerk Clerk session JWT from an authenticated dashboard user. Format: Bearer eyJ....
In: header
Response Body
application/json
application/problem+json
curl -X GET "https://loading/api/v1/onboarding/preferred-organization"{
"$schema": "/api/v1/schemas/PreferredOrganizationOutputBody.json",
"clerk_org_id": "string"
}{
"$schema": "/api/v1/schemas/ErrorModel.json",
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "string",
"message": "string",
"value": null
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Resolve an admin control-plane workspace
Authorization
bearerClerk Clerk session JWT from an authenticated dashboard user. Format: Bearer eyJ....
In: header
Query Parameters
Tenant runtime hostname, for example ayalaland.sonz.ai.
Response Body
application/json
application/problem+json
curl -X GET "https://loading/api/v1/onboarding/workspace-organization?workspace=string"{
"$schema": "/api/v1/schemas/WorkspaceOrganizationOutputBody.json",
"clerk_org_id": "string",
"role": "string",
"workspace": "string"
}{
"$schema": "/api/v1/schemas/ErrorModel.json",
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "string",
"message": "string",
"value": null
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}