---
title: "Setup Call"
method: POST
path: "/comms/livekit/setup-call"
tags: ["provider", "comms", "livekit"]
---

# Setup Call

`POST /comms/livekit/setup-call`

## Headers

- `TENANT` string, required
- `API-KEY` string, required

## Request body

- LivekitSetupCallParams
  - `externalNumber` string, required
  - `trunkNumber` string, required
  - `roomName` string, required

## Response `200`

Successful Response

- LivekitSetupCallResponse
  - `prompt` string, required
  - `initialMessage` string, required
  - `tools` Tool[], required
    - `name` string, required
    - `description` string, required
    - `endpoint` string, nullable
    - `type` 'CUSTOM' | 'PREDEFINED'
    - `parameters` ToolParameter[], required
      - `name` string, required
      - `description` string, required
      - `required` boolean
  - `headers` object, required
  - `webhookUrl` string, required
  - `basePath` string, required
  - `modelType` 'gemini-2.5-flash' | 'claude-3-7-sonnet' | 'claude-3-5-haiku' | 'gpt-5.2' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-realtime' | 'gpt-realtime-mini' | 'gemini-2.5-flash' | 'gemini-2.5-flash-preview-05-20' | 'gemini-2.5-flash-lite' | 'gemini-live'
  - `supportedLanguage` 'multi' | 'en-US' | 'ar-SA'
  - `silenceTrackerMode` 'ENABLED' | 'ON_CALL_END' | 'DISABLED'

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/decodahealth/apis/decoda-api.md) · [All operations](https://skmtc.dev/decodahealth/apis/decoda-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/decodahealth/decoda-api/revisions/4939a65a89d2/schema)