Inceptiva· SDKv0.4.0
API REFERENCE

SSE streaming

POST /v1/agents/{agent_id}/responses/stream

The endpoint accepts the same payload and Idempotency-Key as /responses. Send Accept: text/event-stream and validate the response content type.

shell
curl --no-buffer --request POST \
  "https://api.inceptiva.com/v1/agents/$INCEPTIVA_AGENT_ID/responses/stream" \
  --header "Authorization: Bearer $INCEPTIVA_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Accept: text/event-stream" \
  --data '{"message":"Hello","conversation_id":null,"metadata":{}}'

The normal sequence is response.created, zero or more response.output_text.delta events, then response.completed. error terminates the stream. Close on completion, error, or cancellation. Never retry an initiated generation automatically without reusing its idempotency key.