Create a new account

POST

/api/tenants

Public endpoint that provisions a new account on the Free plan and returns a freshly generated API key. Idempotent on the supplied owner/organization identifier — if an account already exists for it, the existing account is returned instead.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

An account already exists for the supplied organization/owner identifier; the existing account is returned.

Bodyapplication/json

🟢201

🟠400

🟠409

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.snakk.ai/api/tenants' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Example AS",
    "email": "owner@example.com",
    "billing_email": "billing@example.com",
    "external_auth_id": "org_123",
    "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
    "reseller_id": "375ec98c-79ba-4ed8-9a8d-0126981c8632"
}'

Response Example

200 - Example 1

{
    "tenant": {}
}

Modified at 2026-07-08 19:01:40

Detailed health check with dependency status

List agents