Update Organization Properties

curl --request PATCH \
  --url https://api.bland.ai/v1/orgs/{org_id}/properties \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '{
  "updates": {}
}'

import requests

url = "https://api.bland.ai/v1/orgs/{org_id}/properties"

payload = { "updates": {} }
headers = {
    "authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({updates: {}})
};

fetch('https://api.bland.ai/v1/orgs/{org_id}/properties', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bland.ai/v1/orgs/{org_id}/properties",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'updates' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bland.ai/v1/orgs/{org_id}/properties"

	payload := strings.NewReader("{\n  \"updates\": {}\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.bland.ai/v1/orgs/{org_id}/properties")
  .header("authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"updates\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.bland.ai/v1/orgs/{org_id}/properties")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"updates\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "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
}

PATCH

orgs

{org_id}

properties

Update Organization Properties

curl --request PATCH \
  --url https://api.bland.ai/v1/orgs/{org_id}/properties \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '{
  "updates": {}
}'

import requests

url = "https://api.bland.ai/v1/orgs/{org_id}/properties"

payload = { "updates": {} }
headers = {
    "authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({updates: {}})
};

fetch('https://api.bland.ai/v1/orgs/{org_id}/properties', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bland.ai/v1/orgs/{org_id}/properties",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'updates' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bland.ai/v1/orgs/{org_id}/properties"

	payload := strings.NewReader("{\n  \"updates\": {}\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.bland.ai/v1/orgs/{org_id}/properties")
  .header("authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"updates\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.bland.ai/v1/orgs/{org_id}/properties")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"updates\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "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
}

Headers

string

required

Your API key for authentication.

Path Parameters

string

required

The unique identifier of the organization.

Body

object

required

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

object

The updated organization properties.

string

The unique identifier of the organization.

string

The unique slug identifier of the organization.

string

The updated display name of the organization.

string | null

URL of the organization’s image (if set).

string

The organization’s plan. Default: "starter".

string (ISO 8601)

The timestamp of when the organization was created.

integer

The KYC (Know Your Customer) verification level. Default: 0.

string

The placement group of the organization. Default: "blandshared".

boolean

Whether the organization is deleted. Default: false.

boolean

Whether the organization has overdue Stripe payments. Default: false.

boolean

Whether the organization is suspended. Default: false.

integer

The organization’s request rate limit. Default: 5.

string

The type of the organization. Default: "normal".

array

A list of entitlements granted to the organization. Default: [].

object

The updated preferences for the organization.

boolean

Whether the organization prefers to use the Bland URL.

null

Always null on success.

{
  "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

Update Organization Member Permissions Get User Organization Memberships

⌘I

Basic Tutorials

Calls

Voices & Text to Speech

Conversational Pathways

Knowledge Bases

Numbers

Blocked Numbers

Widgets

Tools

Contacts

Memory

Node tests

Agent Testing

Evals

Guard Rails

Web Agents

Live Translation

Custom Twilio Accounts

Batches

Prompts

Account

Organizations

Messaging

SIP Trunks

Custom Dialing Pools

Personas

Citation Schemas

Alarms

Triage

Update Organization Properties

Headers

Path Parameters

Body

Response

​Headers

​Path Parameters

​Body

​Response

Headers

Path Parameters

Body

Response