sessions

Post Session Message

Start the next turn of an existing session.

409 while a turn is active (the lock-by-insert unique index); 402-class SessionGateError with a machine-readable reason on gate failure — nothing is persisted in either case (decision 15: no fake "queued" state).

post/sessions/{session_id}/messages

Path parameters

session_idstring uuid required

Headers

X-Posthog-Session-Idstring nullable
X-Client-Mobilestring nullable

Request body

messagestring required
prompt_sourcestring nullable
queuedboolean

Response

Successful Response

Changes

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