Voice

Set org-wide inbound call defaults

Replace the org's inbound defaults.

A REPLACE, not a merge: voice writes the whole settings row, so a field left out is a field cleared. Read the current values first.

POST rather than PUT because that is the verb voice exposes, and a second spelling for the same operation is worse than an imperfect one.

org_id is stripped from the body and set from the key.

post/voice/agents/global-settings

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/voice/agents/global-settings
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

object required

inbound_default_agent_name, inbound_default_timezone and inbound_default_event_id are the settings; contacts is a JSON STRING, not a list - voice stores it as text.

Response

Successful Response

dataVoicePayload required

One voice object - a collection, an agent, a route, a chat.

Open-shaped: voice adds fields to these bodies on its own release cadence and a dropped-or-added key must not be a 500 in this service.

Changes

No recorded changes to this operation across all 2 revisions of this API.