Skip to main content
POST
/
comms
/
livekit
/
setup-call
Setup Call
curl --request POST \
  --url https://api.decodahealth.com/comms/livekit/setup-call \
  --header 'API-KEY: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'TENANT: <tenant>' \
  --data '
{
  "externalNumber": "<string>",
  "trunkNumber": "<string>",
  "roomName": "<string>"
}
'
{
  "prompt": "<string>",
  "initialMessage": "<string>",
  "tools": [
    {
      "name": "<string>",
      "description": "<string>",
      "parameters": [
        {
          "name": "<string>",
          "description": "<string>",
          "required": true
        }
      ],
      "endpoint": "<string>",
      "type": "CUSTOM"
    }
  ],
  "headers": {},
  "webhookUrl": "<string>",
  "basePath": "<string>",
  "modelType": "gemini-2.5-flash",
  "supportedLanguage": "multi",
  "silenceTrackerMode": "ENABLED"
}

Headers

TENANT
string
required

The tenant you are making this request on behalf of

API-KEY
string
required

Your api key

Body

application/json
externalNumber
string
required
trunkNumber
string
required
roomName
string
required

Response

Successful Response

prompt
string
required
initialMessage
string
required
tools
Tool · object[]
required
headers
Headers · object
required
webhookUrl
string
required
basePath
string
required
modelType
enum<string> | null
Available options:
gemini-2.5-flash,
claude-3-7-sonnet,
claude-3-5-haiku,
gpt-4.1,
gpt-4o-realtime-preview,
gpt-4o-mini-realtime-preview,
gpt-4o,
gpt-4o-mini,
gemini-2.0-flash,
gemini-2.5-flash,
gemini-2.5-flash-preview-05-20,
gemini-2.5-flash-lite,
gemini-live
supportedLanguage
enum<string> | null
Available options:
multi,
en-US,
ar-SA
silenceTrackerMode
enum<string> | null
Available options:
ENABLED,
ON_CALL_END,
DISABLED