Voice

Get the org's receptionist, creating it if absent

IDEMPOTENT: returns the existing receptionist, or creates a default one.

Calling it twice does not produce two receptionists - there is one per organisation. That is why it is a POST that is safe to retry, and why it is not spelled as a create.

post/voice/agents/receptionist

Request

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

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

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.