API REFERENCE

Crear una respuesta

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

shell

curl --request POST \
  "https://api.inceptiva.com/v1/agents/$INCEPTIVA_AGENT_ID/responses" \
  --header "Authorization: Bearer $INCEPTIVA_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: request-unique-id" \
  --data '{
    "message": "Consulta del usuario",
    "conversation_id": null,
    "external_reference": "ticket-4821",
    "metadata": {"customer_id":"123","source":"helpcenter"}
  }'

Campo	Tipo	Requerido	Descripción
`message`	string	Sí	Consulta del usuario
`conversation_id`	UUID o `null`	No	Continúa una conversación concreta
`external_reference`	string o `null`	No	Correlación estable del cliente
`metadata`	object	No	Trazabilidad JSON validada

json

{
  "conversation_id": "00000000-0000-0000-0000-000000000000",
  "response": "Respuesta completa",
  "citations": []
}

Utiliza una clave idempotente nueva por operación lógica. La misma clave y payload recuperan el resultado sin consumir otra vez; reutilizarla con otro payload devuelve 409.