---
title: "Send a message to Max"
method: POST
path: "/public/v1/max/conversations/message"
tags: ["Max Conversations"]
---

# Send a message to Max

`POST /public/v1/max/conversations/message`

Sends a message to Max and returns the conversation once Max has replied. Omit `conversationId` to start a new thread. Max may take a while to answer, since it can call tools and read your data before replying. Requires a USER API key.

## Request body

- object
  - `context` object
    - `folder` string, nullable
    - `threadId` string, nullable
    - `messageId` string, nullable
    - `draftId` string, nullable
    - `draftThreadText` string, nullable
    - `threadSubject` string, nullable
    - `draftContent` string, nullable
    - `email` string, nullable
    - `openedDrafts` object[]
      - `recipients` object[], required
        - `email` string, required
        - `name` string, nullable
      - `draftContent` string, required
      - `subject` string, nullable
      - `draftId` string, nullable
    - `textSelections` object[]
      - `type` 'content' | 'chat', required
      - `content` string, required
      - `hostname` string, nullable
    - `currentUrl` string, nullable
    - `artifactIds` number[]
    - `artifactHtmlBlocks` object[]
      - `artifactId` number, required
      - `blockHtml` string, required
      - `text` string
    - `selectedDesignSystems` string[]
  - `message` string, required
  - `medias` object[], nullable
    - `buffer` object, nullable
    - `mimeType` string, required
    - `fileName` string, required
    - `url` string, nullable
    - `messageId` number
  - `conversationId` number, nullable
  - `autoAcceptPlan` union
    - boolean
    - string
  - `authorizationMode` 'AUTO' | 'SUPERVISED' | 'ASK'
  - `modelTier` 'AUTO' | 'LITE' | 'HIGH'

## Response `201`

Conversation with the reply

- object
  - `ok` true, required
  - `data` PublicMaxConversation, required
    - `id` number, required
    - `name` string, nullable
    - `max_agent_id` number, nullable
    - `channel` string, nullable
    - `is_closed` boolean, nullable
    - `is_archived` boolean, nullable
    - `is_pinned` boolean, nullable
    - `created_at` string, nullable
    - `updated_at` string, nullable
    - `last_message_at` string, nullable
    - `last_message_preview` string, nullable
    - `messages` object[]
    - `current_plan` object, nullable
    - `questions` object[]
    - `message_abort_key` string, nullable

## Other responses

- `401` — Unauthorized — a USER API key is required

## Changes

- **2026-10-03** `666cd9efa9f3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/getfrontline/apis/public-api/changes/public/v1/max/conversations/message/post.md)

---

[API](https://skmtc.dev/getfrontline/apis/public-api.md) · [All operations](https://skmtc.dev/getfrontline/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getfrontline/apis/public-api/revisions/666cd9efa9f3?raw)