---
title: "Ai Call"
method: POST
path: "/comms/call/ai"
tags: ["provider", "comms"]
---

# Ai Call

`POST /comms/call/ai`

Initiate an AI Collections call.

## Headers

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

## Request body

- MakeAICall
  - `assistantType` 'BILLER' | 'CALL_REMINDER' | 'CALL_FOLLOW_UP' | 'CALL_LAB_TECHNICIAN', required
  - `reasonForCall` string, required
  - `patientId` string, required
  - `eventId` string, nullable
  - `provider` 'retell' | 'livekit'

## Response `200`

Successful Response

- CallSummary
  - `id` string, required
  - `sender` UserTiny
    - `id` string, required — The unique identifier for the user.
    - `firstName` string, nullable — The user's first name.
    - `lastName` string, nullable — The user's last name.
    - `phoneNumber` string, nullable — The user's phone number.
    - `email` string, nullable — The user's email address.
    - `type` 'PROVIDER' | 'PATIENT' | 'ASSISTANT', required
    - `locationId` string, nullable — The location of the user.
  - `receiver` UserTiny
    - `id` string, required — The unique identifier for the user.
    - `firstName` string, nullable — The user's first name.
    - `lastName` string, nullable — The user's last name.
    - `phoneNumber` string, nullable — The user's phone number.
    - `email` string, nullable — The user's email address.
    - `type` 'PROVIDER' | 'PATIENT' | 'ASSISTANT', required
    - `locationId` string, nullable — The location of the user.
  - `chatId` string, required
  - `direction` 'INBOUND' | 'OUTBOUND', required
  - `status` 'CREATED' | 'ONGOING' | 'TRANSFERRED' | 'DISCONNECTED' | 'FAILED' | 'FINISHED' | 'VOICEMAIL', required
  - `completedDate` string, date-time, nullable
  - `retellCallId` string, nullable
  - `disconnectionReason` string, nullable
  - `pathToAudio` string, nullable
  - `summary` string, nullable
  - `context` object, nullable
  - `createdDate` string, date-time, nullable
  - `toolCalls` ToolCall[]
    - `id` string, required
    - `toolName` string, required
    - `toolArguments` object, required
    - `toolCallId` string, nullable
  - `tags` TagSummary[]
    - `name` string, required
    - `description` string, nullable
    - `useForAlerts` boolean, required
    - `useForCalls` boolean, required
    - `id` string, required
  - `invoiceId` string, nullable
  - `type` 'MANUAL' | 'AI'
  - `locationId` string, nullable

## 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)