Skip to content
Tradr docs

Stream an assistant reply for an existing conversation (SSE).

POST
/api/advisor/conversations/{id}/messages/stream
curl --request POST \
  --url https://api.tradr.cloud/api/advisor/conversations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/messages/stream \
  --header 'Content-Type: application/json' \
  --data '{ "attachments": [ { "dataBase64": "example", "format": "png", "type": "image" } ], "clientMessageId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "personaId": "example", "text": "example" }'

Sends a user message to an existing conversation and streams the assistant reply as Server-Sent Events. Frames: event: token ({delta}), event: usage ({promptTokens, completionTokens}), event: done ({messageId, deduped?, source?}), event: error ({code, upstreamStatus, message}). Pre-stream failures return a JSON error envelope (no SSE) with the appropriate HTTP status. Rate limited to 30 requests per 60 s.

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string format: uuid

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
attachments
Array<object>
<= 4 items
object
dataBase64
string
<= 4500000 characters
format
string
Allowed values: png jpeg webp
type
string
Allowed values: image
clientMessageId
required
string format: uuid
personaId
string
text
required
string
>= 1 characters <= 50000 characters

Responses

Section titled “Responses”

200

Section titled “200”

Server-Sent Event stream.

Media typetext/event-stream
string

400

Section titled “400”

Validation / image / cap error envelope (IMAGE_TOO_LARGE above the per-image byte cap).

402

Section titled “402”

Platform billing refusal — INSUFFICIENT_CREDITS / ALLOWANCE_EXHAUSTED (allowance model + allowance and credits exhausted) / INSUFFICIENT_CREDITS_ALLOWANCE_AVAILABLE (non-allowance model + free allowance turns remain) / MODEL_NOT_AVAILABLE / BILLING_NOT_AVAILABLE.

403

Section titled “403”

Monthly advisor image quota exceeded for the user’s tier (TIER_LIMIT_IMAGES) — text-only turns unaffected.

404

Section titled “404”

Conversation not found (or not owned).

413

Section titled “413”

Request body exceeds the byte-cap floor (PAYLOAD_TOO_LARGE).

429

Section titled “429”

Stream in progress

500

Section titled “500”

Provider-key decryption failure.