Skip to main content
GET
Read a sent message and its reply

Authorizations

Authorization
string
header
required

Effective API key. Send Authorization: Bearer sk-eai-...

Path Parameters

id
string<uuid>
required

Session UUID, e.g. 00000000-0000-4000-8000-000000000001.

Example:

"00000000-0000-4000-8000-000000000001"

messageId
string
required

Message ID returned when the message was sent, or listed in the conversation.

Required string length: 1 - 200
Example:

"00000000-0000-4000-8000-000000000002"

Response

Message status and reply.

id
string
required

Message ID returned when the message was sent, or listed in the conversation.

Required string length: 1 - 200
Example:

"00000000-0000-4000-8000-000000000002"

status
enum<string>
required

queued until the agent picks the message up, running while it works, then succeeded or failed. Messages are handled one at a time, in the order sent.

Available options:
queued,
running,
succeeded,
failed
message
string
required

The text that was sent.

reply
string | null
required

The agent’s reply in Markdown, once the message has finished; null before then. A failed message can carry a partial reply.

createdAt
string<date-time>
required

When the message was sent, in UTC.

finishedAt
string<date-time> | null
required

When the reply finished, in UTC; null until then.

failure
object | null
required

Why the message failed; null unless status is failed.