Dialer

Update Dialer Settings

CONTACTS NOBODY. Change the organisation's dialer settings. ADMIN ONLY.

These flags decide whether the organisation's call transcripts are sent to third-party providers (live coach, transcription, automatic outcome logging), so the organisation is the key's own and a personal key held by an Admin or Owner is required (require_org_admin refuses machine keys; voice's own admin gate cannot see an API key). Only the fields sent change; an empty body is a 422.

patch/dialer/dispositions/settings

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/dialer/dispositions/settings
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

auto_disposition_enabledboolean nullable

Suggest a disposition from the call transcript after a connected call.

live_coach_enabledboolean nullable

Live AI coach in the dialer drawer during calls. Sends call audio text to a model provider.

live_coach_stt_mode'off' | 'shadow' | 'primary' nullable

Live transcription source: off (Twilio), shadow (Twilio plus a comparison), primary.

auto_disposition_mode'off' | 'phone' | 'phone_jev' nullable

Automatic outcome logging: off, phone (telephony outcomes) or phone_jev (plus suggestions).

auto_disposition_thresholdnumber nullable

Kept for older clients; no longer gates a write.

Response

Successful Response

dataDialerPayload required

An open envelope for one dialer result.

Open because voice owns the shape of a session, a call stub and a queue stat, and it grows them without a contract bump here. A dropped field would otherwise turn an added upstream field into a removed public one.

Changes

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