Skip to main content
POST
/
v1
/
sessions
/
{sessionId}
/
messages
curl --request POST \
  --url https://api.synthra.ai/v1/sessions/session_abc123def456/messages \
  --header 'Authorization: Bearer synthra_live_abc123def456' \
  --header 'Content-Type: application/json' \
  --data '{
    "content": "What is the current price of SOL?",
    "role": "user"
  }'

{
  "messageId": "msg_xyz789ghi012",
  "sessionId": "session_abc123def456",
  "role": "assistant",
  "content": "The current price of Solana (SOL) is $147.23 USD, up 3.2% in the last 24 hours.",
  "tokens": 28,
  "createdAt": "2024-03-08T14:30:15Z"
}

​
Authorization

​
Authorization
string
required
Bearer token. Format: Bearer synthra_live_abc123def456

​
Path Parameters

​
sessionId
string
required
Unique session identifier. Format: session_<16 chars>

​
Body Parameters

​
content
string
required
Message content. Max 10,000 characters.
​
role
string
default:"user"
Message role. Options: user, system
​
streaming
boolean
default:"false"
Enable streaming response via WebSocket
​
metadata
object
Optional metadata to attach to message

​
Response

​
messageId
string
Unique message identifier
​
sessionId
string
Session identifier
​
role
string
Message role (assistant)
​
content
string
AI-generated response content
​
tokens
number
Token count for this message
​
createdAt
string
ISO 8601 timestamp
curl --request POST \
  --url https://api.synthra.ai/v1/sessions/session_abc123def456/messages \
  --header 'Authorization: Bearer synthra_live_abc123def456' \
  --header 'Content-Type: application/json' \
  --data '{
    "content": "What is the current price of SOL?",
    "role": "user"
  }'

{
  "messageId": "msg_xyz789ghi012",
  "sessionId": "session_abc123def456",
  "role": "assistant",
  "content": "The current price of Solana (SOL) is $147.23 USD, up 3.2% in the last 24 hours.",
  "tokens": 28,
  "createdAt": "2024-03-08T14:30:15Z"
}