API REFERENCE

Streaming SSE

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

Acepta el mismo body y Idempotency-Key que /responses. Debes enviar Accept: text/event-stream y validar que la respuesta tenga Content-Type: text/event-stream.

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" \
  --header "Idempotency-Key: request-unique-id" \
  --data '{"message":"Hola","conversation_id":null,"metadata":{}}'

El orden normal es response.created, cero o más response.output_text.delta y response.completed. error termina el flujo con code y message.

text

event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":"fragmento"}

event: response.completed
data: {"type":"response.completed","response":{"conversation_id":"UUID","output_text":"Respuesta completa","citations":[]}}

No reintentes automáticamente un stream iniciado sin reutilizar la misma clave idempotente: podrías duplicar el mensaje. Cierra la conexión al completar, recibir un error o cancelar.