Update an organization
Partially updates an organization's settings.
Endpoint
PATCH/organizations/:id
Body
| Name | Type | Description |
|---|---|---|
name | string | Organization name. |
timezone | string | IANA timezone. |
logo_url | string | Logo URL or storage key. |
default_locale | string | en or es. |
default_phone_country_iso | string | e.g. US. |
default_phone_country_code | string | e.g. +1. |
wallet_auto_recharge_enabled | boolean | Turn automatic wallet recharge on or off. |
wallet_auto_recharge_minimum | number | Recharge threshold in USD. |
wallet_auto_recharge_amount | number | Recharge amount in USD. |
wallet_auto_recharge_max_per_day | number | Maximum automatic recharges in 24 hours. |
wallet_auto_recharge_max_per_30_days | number | Maximum automatic recharges in 30 days. |
channel_webchat_enabled | boolean | Enable the webchat channel. |
mcp_enabled | boolean | Allow 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_minimummust be at least the platform minimum threshold and not below the organization's recent average daily usage.wallet_auto_recharge_amountmust be greater thanwallet_auto_recharge_minimumand 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
| Status | When |
|---|---|
400 Bad Request | An 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.