Append a message without generating
POST/api/v1/llm/append-message
Appends a context message to the thread's history without starting generation for this call. Use it to record a system note, an external event or other context that later generations should see without triggering a reply.
Read conversation-state to confirm the event: append assigns the next monotonic
sequence immediately and publishes a message event. ROLE_USER opens a new user
turn; other roles join the most recent user turn. Choose the role for how the event
should appear in history, without changing the fact it records.
Append bypasses the interrupt policy and pending queue. It can run while another turn is active, but that turn may already have assembled its provider request. This call does not stop already running work or guarantee zero account-level cost: storage and future model input can still cost money.
Request
Responses
- 200
Message appended
Document ID: DOC-MA-conversations-api-appendMessage. Section identities and revisions.
| Section | Stable reference |
|---|---|
| Overview | DOC-MA-conversations-api-appendMessage#overview |
| Request | DOC-MA-conversations-api-appendMessage#request |
| Responses | DOC-MA-conversations-api-appendMessage#responses |