Create an organization

POST

/api/orgs

Creates a new organization owned by the authenticated user. The organization is placed under the reseller of the brand/domain the request is made from. The caller automatically becomes the owner.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

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

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Organization created.

Bodyapplication/json

🟠400

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.snakk.ai/api/orgs' \
--header 'X-Brand-Host;' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Example AS"
}'

Response Example

201 - Success

{
    "org": {
        "id": "8f1c2d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
        "name": "Example AS",
        "api_key": "k3y_abc123...",
        "role": "owner"
    }
}

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

List my organizations

Delete an organization