v1

Send Session Message

Send a message to a session.

409 for mention, non-interactive, closed, archived, and out-of-budget sessions. Returns the created message; a retried send with the same idempotency_key returns the original one. The message is answered once the session's status is idle or closed.

post/v1/sessions/{id}/messages

Request

  • Base URL
    https://api.ellipsis.dev
  • URL
    https://api.ellipsis.dev/v1/sessions/{id}/messages
  • Auth
    HTTP bearer

Path parameters

idstring required

Headers

user-agentstring nullable

Request body

idempotency_keystring nullable

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.

messagestring required

The message text. May be empty when images is not.

Response

Successful Response

Changes

No recorded changes to this operation across all 1 revision of this API.