Saltar al contenido principal
POST
Copiloto de IA de una auditoría — acotado a ella, streaming SSE

Autorizaciones

X-API-Key
string
header
requerido

Tu API key en el header X-API-Key.

Encabezados

X-Audit-Id
string | null

Id de la auditoría que el cliente cree estar leyendo (opcional, como X-Case-Id). Si viene y no coincide con audit_id de la ruta, la respuesta es 400 audit_id_mismatch antes de leer nada.

X-Case-Id
string | null

Caso activo (opcional): el token de un caso que podés ver. La consulta queda en el registro de actividad de ese caso y resuelve también sus labels propias. Un caso que no existe, se borró o ya no está compartido con vos da 400 case_unavailable y la consulta no se hace (sin cobro).

Parámetros de ruta

audit_id
string
requerido

Id de la auditoría: minúsculas, dígitos, _ y -, de 1 a 64 caracteres, empezando por letra o dígito (los que lista GET /v1/audit).

Cuerpo

application/json
message
string
requerido

La pregunta del usuario.

Required string length: 1 - 4000
history
History · object[]

Turnos previos {role: user|assistant, content} de esta conversación (se usan los últimos 12).

Maximum array length: 40
context
Context · object | null

La pantalla: {section, selection: {kind: finding|lead|proof, id}}. Se valida contra la auditoría: lo que no existe en ella se ignora.

Respuesta

Successful Response