---
title: "Chat"
method: POST
path: "/api/chat"
tags: ["chat"]
---

# Chat

`POST /api/chat`

## Request

- Base URL: `https://api.advisorppc.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.advisorppc.com/api/chat`
- Auth: HTTP bearer

## Headers

- `X-Tenant-Id` integer, nullable

## Request body

- ChatIn
  - `resumable` boolean
  - `question_cards` boolean
  - `continuation` AppChatContinuationAnswerIn
    - `question_id` integer, required
    - `version` integer, required
    - `continuation_token` string, required
    - `option_id` string, nullable
    - `free_text` string, nullable
  - `messages` ChatMessageIn[], required
    - `role` 'user' | 'assistant', required
    - `content` string, required
  - `attachments` ChatAttachmentRefIn[]
    - `assetId` string, required
  - `conversationId` integer, nullable
  - `clientRequestId` string, nullable
  - `model` string, nullable
  - `effort` 'none' | 'low' | 'medium' | 'high' | 'xhigh' | 'max', nullable
  - `writeMode` 'manual' | 'accept' | 'plan' | 'auto'
  - `agentInstanceId` integer, nullable
  - `connector` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `404`: Attachment not found in the actor's tenant scope.
- `409`: Attachment metadata is not ready.
- `410`: Attachment metadata has expired.
- `413`: Combined attachment size exceeds the turn limit.
- `422`: Validation Error
- `503`: Chat or attachment delivery is not configured.

---

[API](https://skmtc.dev/advisorppc/apis/advisorppc-api.md) · [All operations](https://skmtc.dev/advisorppc/apis/advisorppc-api/llms.txt) · [OpenAPI document](https://skmtc.dev/advisorppc/apis/advisorppc-api/revisions/3441bd729e0c?raw)
