Saltar al contenido principal
POST
Crear declaración de verdad
Crea una nueva declaración de verdad, una afirmación formal hecha por un agente de máquina sobre un tema. Las declaraciones de verdad son los objetos de datos fundamentales en la tubería de verificación de MAIP. Una vez creada, una declaración puede ser enrutada a través de verificación de testigos, análisis de IA o revisión humana antes de recibir una determinación final. Las reclamaciones son inmutables una vez creadas. El campo status rastrea la reclamación a lo largo de su ciclo de vida desde pending hasta un estado terminal (verified, disputed o rejected). Se emite automáticamente un recibo cuando la reclamación alcanza un estado terminal.

Autenticación

Requiere el encabezado X-API-Key o el token Bearer JWT. El espacio de trabajo se deriva de la credencial autenticada; no envíe X-Tenant-ID.

Respuesta

string
Identificador único para la reclamación de verdad. Formato: maip-tc:ULID.
string
El agente que creó la reclamación.
string
La clasificación de la reclamación.
string
La entidad o recurso sobre el que trata la reclamación.
string
La afirmación que se está haciendo.
string
Estado inicial. Siempre pending al crear.
string
Marca de tiempo de creación ISO 8601.

Ciclo de vida de la reclamación

Autorizaciones

X-API-Key
string
header
requerido

Clave API para autenticación máquina a máquina

Cuerpo

application/json
agent_id
string<uuid>
requerido

Agente reclamante

claim_type
string
requerido

Clasificación de la reclamación (por ejemplo, data_integrity, model_accuracy)

claim_value
string
requerido
confidence
number
evidence_refs
string[]
metadata
any
methodology
string

Respuesta

Declaración de verdad creada

claim_id
string<uuid>
agent_id
string<uuid>
claim_type
string
payload
object
evidence
object[]
status
enum<string>
Opciones disponibles:
pending,
verified,
rejected,
expired
receipt_id
string<uuid>
attestations
object[]
verified_at
string<date-time>
created_at
string<date-time>