v1

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

Message

Get a message

Canonical recovery endpoint: full composed state of a message.

get/messages/{message_id}

Path parameters

message_idinteger required

ID of the message to fetch.

Query parameters

cookie_namestring nullable

Response

Successful Response

idinteger required

ID of the message.

chat_idinteger required

ID of the chat the message belongs to.

parent_idinteger nullable required

ID of the parent user message for assistant replies, else null.

rolestring required

Role of the message author.

contentstring required

Text content of the message.

statestring nullable required

Processing state of the message.

errorstring nullable required

Error string if generation failed, else null.

hintstring nullable required

Optional hint about the message state.

created_atstring date-time required

When the message was created.

updated_atstring date-time required

When the message was last updated.

usageobject nullable required

Token usage and cost metadata, if available.

Example response

{
  "id": 200,
  "chat_id": 42,
  "parent_id": 199,
  "role": "assistant",
  "content": "Here is the summary you requested.",
  "state": "completed",
  "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-01-15T10:30:05Z",
  "usage": {
    "completion_tokens": 80,
    "prompt_tokens": 120
  },
  "tool_calls": [],
  "files": []
}