Create Organization

POST

/org

POST

/api/v1/org

$ curl -X POST https://app.rightbrain.ai/api/v1/org \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "name": "Meridian Freight Logistics",
>   "contact_email": "[email protected]"
> }'

1 {
2   "name": "Meridian Freight Logistics",
3   "contact_email": "[email protected]",
4   "id": "019a2f10-8a1c-7e42-9b53-1c9d4e7b6f01",
5   "avatar_url": "https://cdn.rightbrain.ai/assets/avatars/organization/019a2f10-8a1c-7e42-9b53-1c9d4e7b6f01/base.png",
6   "public_metadata": {},
7   "low_credit_alerts": false,
8   "usage_based_pricing_enabled": false,
9   "plan": "trial",
10   "plan_status": "active",
11   "trial_ends_at": "2026-08-24T00:00:00Z",
12   "auto_topup_config": {
13     "enabled": false
14   },
15   "account": {
16     "org_id": "019a2f10-8a1c-7e42-9b53-1c9d4e7b6f01",
17     "id": "019a2f10-8a2c-7e43-8e97-1c9d4e7b6f0a",
18     "credits": 0,
19     "modified": "2026-07-25T00:00:00Z"
20   }
21 }

Create a new organization

Authentication

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

Request

This endpoint expects an object.

namestringRequiredformat: "^[a-zA-Z0-9\-_ ]+$"

Organization name

contact_emailstringRequiredformat: "email"

Response

Organization created successfully

namestring

contact_emailstringformat: "email"

idstringformat: "uuid"

avatar_urlstring or nullOptional

public_metadatamap from strings to stringsOptionalDefaults to {}

low_credit_alertsbooleanOptionalDefaults to false

usage_based_pricing_enabledbooleanOptionalDefaults to false

planenumOptional

plan_statusenumOptional

plan_intervalenum or nullOptional

pending_planenum or nullOptional

pending_plan_intervalenum or nullOptional

pending_plan_datedatetime or nullOptional

trial_ends_atdatetime or nullOptional

grace_period_ends_atdatetime or nullOptional

auto_topup_configmap from strings to anyOptionalDefaults to {}

accountobject or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

422

Unprocessable Entity Error

500

Internal Server Error