Skip to main content
PATCH
Update organization settings

Authorizations

X-API-Key
string
header
required

API key for external access. Format: tp_live_<32-hex-chars>. Create keys in the TalkPilot Dashboard under Settings > API.

Path Parameters

orgId
string<uuid>
required

Organization UUID (from GET /v1/organization)

Body

application/json

Writable settings. name, max_concurrent_calls and concurrency_overflow_number are read-only; unknown fields are ignored.

auto_delete_done_calls
boolean
cascade_done_same_number
boolean
calendar_status_update
boolean
forward_call_email
boolean
transfer_popup_enabled
boolean
notdienst_bereiche
string[] | null

Trimmed and de-duplicated; empty array becomes null

Response

Updated organization

id
string<uuid>
name
string
read-only
auto_delete_done_calls
boolean | null

Automatically move completed calls to trash

cascade_done_same_number
boolean

Marking a call done also marks the other open calls of the same number

calendar_status_update
boolean

Derive employee status from connected calendars

forward_call_email
boolean

Allow forwarding a call by e-mail from the Dashboard

transfer_popup_enabled
boolean

Show employees a caller card with transcript on transfer

notdienst_bereiche
string[] | null

Selectable emergency-duty areas (null/empty = a single emergency service)

max_concurrent_calls
integer | null
read-only

Parallel inbound calls allowed across all numbers (null = unlimited). Managed by TalkPilot

concurrency_overflow_number
string | null
read-only

E.164 number overflow callers are forwarded to (null = busy tone). Managed by TalkPilot

created_at
string<date-time>
updated_at
string<date-time>