Sign in

v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-25173140700.7 KB
Message

Submit a message with attachments

Send a multipart message with optional file uploads and enqueue generation.

post/messages/submit

Query parameters

cookie_namestring nullable

Response

Successful Response

statestring nullable

Current lifecycle state of the record.

state_reasonstring nullable

Optional explanation for the current state.

state_changed_atstring date-time nullable

UTC timestamp when the state last changed.

idinteger nullable

Primary key for the message.

created_atstring date-time

Timestamp when the message was created.

updated_atstring date-time

Timestamp when the message was last updated.

creator_user_idinteger required

ID of the user who created the message.

chat_idinteger required

ID of the chat the message belongs to.

rolestring required

Role of the message author (see llama-index MessageRole values).

contentstring required

Rendered content of the message.

sent_user_msgstring nullable required

Original user-sent message text, if applicable.

parent_idinteger nullable required

ID of the parent message in a threaded conversation.

completedboolean

DEPRECATED. Whether the message has finished processing.

errorstring nullable required

DEPRECATED. Error message captured during processing, if any.

hintstring nullable required

Hint shown to the user about the next action.

llm_catalog_idinteger nullable

ID of the LLM catalog entry used for this message.

llm_settings_idinteger nullable

ID of the LLM settings used for this message.

usageobject nullable

Token usage metadata recorded for this message.

celery_task_idstring nullable

ID of the Celery task processing this message, if any.

Example response

{
  "state": "NEW",
  "state_reason": "Processing failed: timeout",
  "state_changed_at": "2026-01-16T08:00:00Z",
  "id": 1,
  "created_at": "2026-06-23T12:00:00Z",
  "updated_at": "2026-06-23T12:00:00Z",
  "creator_user_id": 1,
  "chat_id": 1,
  "role": "user",
  "content": "Hello, how can I help you?",
  "sent_user_msg": "Summarize the attached document.",
  "parent_id": 1,
  "completed": true,
  "error": "Model timed out",
  "hint": "You can ask a follow-up question.",
  "llm_catalog_id": 1,
  "llm_settings_id": 1,
  "usage": {
    "completion_tokens": 120,
    "prompt_tokens": 50
  },
  "celery_task_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}