POST /sessions/{session_id}/messages
Send a message to a session.
TypeScript SDKThe npm client, generated from the API spec.Python SDKThe PyPI client, sync and async.
| Method | Path |
|---|---|
| POST | /v1/sessions/{session_id}/messages |
409 for react/cron, non-interactive, and closed sessions. Returns the created message so the caller can track it by id; a retried send with the same idempotency_key returns the original message.
Path parameters
session_idstringrequired
curl -X POST "https://api.ellipsis.dev/v1/sessions/{session_id}/messages" \
-H "Authorization: Bearer $ELLIPSIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"message":"..."}'import os
from ellipsis import Ellipsis
client = Ellipsis(api_key=os.environ["ELLIPSIS_API_TOKEN"])
result = client.sessions.send_message("...", "...")
print(result)import { Ellipsis } from '@ellipsis-dev/sdk';
const client = new Ellipsis({
apiKey: process.env.ELLIPSIS_API_TOKEN!,
});
const result = await client.sessions.sendMessage('...', { message: '...' });
console.log(result);Request
Example request body
{
"idempotency_key": "string",
"message": "string"
}
Body parameters
idempotency_keystring
Optional retry-safety key, unique per (session, key): a retry with the same key returns the original message — no duplicate message, no double turn, no double spend. The SDK auto-generates one per send.
messagestringrequired
The message text.
Response
Example response · 200
{
}