Conversation

Send Message (sync)

Sends a message and waits for the full response.

POST/api/message-sync

Request Body

• message (string, required): The user's message.
• sessionId (string, optional): The session to use for this message.
• imageData (object, optional):
  • base64 (string): Base64-encoded image.
  • mimeType (string): The MIME type of the image (e.g., image/png).
• fileData (object, optional):
  • base64 (string): Base64-encoded file data.
  • mimeType (string): The MIME type of the file (e.g., application/pdf).
  • filename (string, optional): The filename.

Responses

Accepted (202)

{
  "status": "processing",
  "sessionId": "b4a2a3e8-72b1-4d00-a5c3-1a2c3d4e5f6a"
}

Error (400)

{
  "error": "Missing message content"
}

Send Message (async)

Sends a message and returns immediately. The full response will be sent over WebSocket.

POST/api/message

Request Body

• message (string, required): The user's message.
• sessionId (string, optional): The session to use for this message.
• imageData (object, optional):
  • base64 (string): Base64-encoded image.
  • mimeType (string): The MIME type of the image (e.g., image/png).
• fileData (object, optional):
  • base64 (string): Base64-encoded file data.
  • mimeType (string): The MIME type of the file (e.g., application/pdf).
  • filename (string, optional): The filename.
• stream (boolean, optional): Set to true to receive streaming chunks over WebSocket.

Responses

Accepted (202)

{
  "status": "processing",
  "sessionId": "b4a2a3e8-72b1-4d00-a5c3-1a2c3d4e5f6a"
}

Reset Conversation

Resets the conversation history for a given session.

POST/api/reset

Request Body

• sessionId (string, optional): The ID of the session to reset.

Responses

Success (200)

{
  "status": "reset initiated",
  "sessionId": "b4a2a3e8-72b1-4d00-a5c3-1a2c3d4e5f6a"
}

Supported File Types

File parts currently support:

• PDF files (application/pdf)
• Audio files (audio/mp3, audio/wav) - with OpenAI gpt-4o-audio-preview and Google Gemini models