Update an organization

Partially updates an organization's settings.

Endpoint

PATCH
/organizations/:id

Body

NameTypeDescription
namestringOrganization name.
timezonestringIANA timezone.
logo_urlstringLogo URL or storage key.
default_localestringen or es.
default_phone_country_isostringe.g. US.
default_phone_country_codestringe.g. +1.
wallet_auto_recharge_enabledbooleanTurn automatic wallet recharge on or off.
wallet_auto_recharge_minimumnumberRecharge threshold in USD.
wallet_auto_recharge_amountnumberRecharge amount in USD.
wallet_auto_recharge_max_per_daynumberMaximum automatic recharges in 24 hours.
wallet_auto_recharge_max_per_30_daysnumberMaximum automatic recharges in 30 days.
channel_webchat_enabledbooleanEnable the webchat channel.
mcp_enabledbooleanAllow access through the MCP server.

Billing, subscription, wallet balance, rate limit and automation limit fields are read-only: they are ignored if you send them.

Automatic recharge rules

When you enable automatic recharge or change its threshold:

  • wallet_auto_recharge_minimum must be at least the platform minimum threshold and not below the organization's recent average daily usage.
  • wallet_auto_recharge_amount must be greater than wallet_auto_recharge_minimum and large enough to cover several days of average usage.

The error message states the exact minimum allowed for your organization.

Request

Response

Returns the updated organization object.

json

Errors

StatusWhen
400 Bad RequestAn invalid value (e.g. default_locale not en/es), an unknown field, or an automatic recharge configuration that breaks the rules above.

Report an issue with this documentation

Please log in to report issues with our documentation.