Send Session Message

Send a message to a conversation session with automatic renewal tracking

Sending a message automatically updates the session’s last activity timestamp. If auto-renewal is enabled, the session will be renewed, extending its expiration time.

Path Parameters

sessionId · string · required

The unique identifier of the session

Request Body

content · string · required

The message content (maximum 4000 characters)

metadata · object

Optional metadata to attach to the message

attachments · array

Optional array of attachments

Response

id · string

Unique identifier of the created message

content · string

The message content

authorId · string

UUID of the message author (user or agent)

createdAt · string

ISO timestamp of message creation

metadata · object

Any metadata attached to the message

sessionStatus · object

Current session status after sending the message

Show Session Status Properties

expiresAt · string

Updated expiration timestamp

renewalCount · number

Total number of times the session has been renewed

wasRenewed · boolean

Whether the session was renewed by this message

isNearExpiration · boolean

Whether the session is within the warning threshold

Error Responses

// 404 - Session not found
{
  "error": "Session not found",
  "details": {
    "sessionId": "abc-123"
  }
}

// 410 - Session expired
{
  "error": "Session has expired",
  "details": {
    "sessionId": "abc-123",
    "expiresAt": "2024-01-15T10:30:00Z"
  }
}

// 400 - Invalid content
{
  "error": "Content exceeds maximum length of 4000 characters"
}