Sign in
Max Conversations

Send a message to Max

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.

post/public/v1/max/conversations/message

Request body

messagestring required
conversationIdnumber nullable
authorizationMode'AUTO' | 'SUPERVISED' | 'ASK'
modelTier'AUTO' | 'LITE' | 'HIGH'

Example request

{
  "context": {
    "folder": "example",
    "threadId": "example",
    "messageId": "example",
    "draftId": "example",
    "draftThreadText": "example",
    "threadSubject": "example",
    "draftContent": "example",
    "email": "example",
    "openedDrafts": [
      {
        "recipients": [
          {
            "email": "example",
            "name": "example"
          }
        ],
        "draftContent": "example",
        "subject": "example",
        "draftId": "example"
      }
    ],
    "textSelections": [
      {
        "type": "content",
        "content": "example",
        "hostname": "example"
      }
    ],
    "currentUrl": "example",
    "artifactIds": [
      1
    ],
    "artifactHtmlBlocks": [
      {
        "artifactId": 1,
        "blockHtml": "example",
        "text": "example"
      }
    ],
    "selectedDesignSystems": [
      "example"
    ]
  },
  "message": "example",
  "medias": [
    {
      "mimeType": "example",
      "fileName": "example",
      "url": "example",
      "messageId": 1
    }
  ],
  "conversationId": 1,
  "autoAcceptPlan": "example",
  "authorizationMode": "AUTO",
  "modelTier": "AUTO"
}

Response

Conversation with the reply

oktrue required

Example response

{
  "ok": true,
  "data": {
    "id": 8123,
    "name": "Follow-up on Acme renewal",
    "max_agent_id": 44,
    "channel": "EXTENSION",
    "created_at": "2026-08-09T10:00:00.000Z",
    "updated_at": "2026-08-09T10:05:00.000Z",
    "last_message_at": "2026-08-09T10:05:00.000Z",
    "last_message_preview": "I've drafted the reply…",
    "message_abort_key": "abort:8123:91"
  }
}

Changes

Changed in 1 of the 2 revisions of this API.1