> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Update Organization Properties
> Modify specific properties of an organization.
### Headers
Your API key for authentication.
### Path Parameters
The unique identifier of the organization.
### Body
An object containing the properties to update.\
**Valid keys:**
* `"org_display_name"` (string) - The display name of the organization. Must be between **1 and 30 characters**.
* `"preferences"` (object) - Preference settings for the organization:
* `"use_bland_url"` (boolean) - Whether the organization prefers to use the Bland URL.
* `"recording_lifespan_days"` (integer) - The lifespan of recordings in days. Must be between **1 and 1825** (inclusive) or `-1` to disable retention.
### Response
The updated organization properties.
The unique identifier of the organization.
The unique slug identifier of the organization.
The updated display name of the organization.
URL of the organization's image (if set).
The organization's plan. Default: `"starter"`.
The timestamp of when the organization was created.
The KYC (Know Your Customer) verification level. Default: `0`.
The placement group of the organization. Default: `"blandshared"`.
Whether the organization is deleted. Default: `false`.
Whether the organization has overdue Stripe payments. Default: `false`.
Whether the organization is suspended. Default: `false`.
The organization's request rate limit. Default: `5`.
The type of the organization. Default: `"normal"`.
A list of entitlements granted to the organization. Default: `[]`.
The updated preferences for the organization.
Whether the organization prefers to use the Bland URL.
Always `null` on success.
```json Response theme={null}
{
"data": {
"id": "d122b4cf-1614-4124-aa28-15f81a09988f",
"org_slug": "133906ea-d750-4a15-80fa-d6aef584dc58",
"org_display_name": "Org Name",
"org_image_url": null,
"org_plan": "starter",
"org_creation_date": "2025-02-14T06:46:09.818Z",
"kyc_level": 0,
"placement_group": "blandshared",
"is_deleted": false,
"is_stripe_overdue": false,
"is_suspended": false,
"org_rate_limit": 5,
"org_type": "normal",
"entitlements": [],
"preferences": {
"use_bland_url": false
}
},
"errors": null
}
```
***
Docs for agents: [llms.txt](/llms.txt)