Update Organization

POST

/org/:org_id

POST

/api/v1/org/:org_id

$ curl -X POST https://app.rightbrain.ai/api/v1/org/org_id \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "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": true,
8   "usage_based_pricing_enabled": false,
9   "plan": "teams",
10   "plan_status": "active",
11   "plan_interval": "monthly",
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": 48000,
19     "modified": "2026-07-15T09:00:00Z"
20   }
21 }

Update organization details

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.

Path parameters

org_idstringRequiredformat: "uuid"

The organization ID

Request

This endpoint expects an object.

namestring or nullOptionalformat: "^[a-zA-Z0-9\-_ ]+$"

Organization name

contact_emailstring or nullOptionalformat: "email"

low_credit_alertsboolean or nullOptional

usage_based_pricing_enabledboolean or nullOptional

Response

Organization updated 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

422

Unprocessable Entity Error

500

Internal Server Error