> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar Declaração de Verdade

> Envie uma nova reivindicação de verdade de um agente de máquina para verificação

Cria uma nova declaração de verdade — uma afirmação formal feita por um agente de máquina sobre um assunto. As declarações de verdade são os objetos de dados fundamentais no pipeline de verificação MAIP. Uma vez criada, uma declaração pode ser roteada por verificação de testemunha, análise de IA ou revisão humana antes de receber uma determinação final.

As reivindicações são imutáveis ​​depois de criadas. O campo `status` rastreia a reivindicação ao longo de seu ciclo de vida, de `pending` a um estado terminal (`verified`, `disputed` ou `rejected`). Um recibo é automaticamente emitido quando a reivindicação atinge um estado terminal.

### Autenticação

Requer cabeçalho `X-API-Key` ou token JWT de portador. O espaço de trabalho é derivado da credencial autenticada; não envie `X-Tenant-ID`.

### Resposta

**id** `string`

Identificador único para a reivindicação de verdade. Formato: `maip-tc:ULID`.

**agent\_id** `string`

O agente que criou a reivindicação.

**claim\_type** `string`

A classificação da reivindicação.

**subject** `string`

A entidade ou recurso sobre o qual a reivindicação se refere.

**assertion** `string`

A afirmação que está sendo feita.

**status** `string`

Status inicial. Sempre `pending` na criação.

**created\_at** `string`

Carimbo de data/hora de criação ISO 8601.

### Ciclo de Vida da Reivindicação

| Status | Descrição |
| :- | :- |
| `pending` | Criado, aguardando verificação |
| `verifying` | Verificação em andamento (testemunha, IA ou humano) |
| `verified` | Reivindicação confirmada como verdadeira |
| `disputed` | Reivindicação contestada -- evidências conflitantes encontradas |
| `rejected` | Reivindicação determinada como falsa |


## OpenAPI

````yaml pt/mint-openapi.yaml POST /v1/truth/claim
openapi: 3.0.3
info:
  title: Truthlocks API
  description: >-
    Truthlocks é uma infraestrutura de verificação universal para documentos,
    credenciais e ativos digitais.

    Esta especificação define a API canônica para interagir com os serviços
    Truthlocks.


    ## URLs Base

    - **Produção**: `https://api.truthlocks.com`

    - **Sandbox**: `https://sandbox-api.truthlocks.com`


    ## Autenticação

    - **Chaves de API**: Use o cabeçalho `X-API-Key` para operações máquina a
    máquina

    - **Tokens de Portador**: Use `Authorization: Bearer <jwt>` para operações
    iniciadas pelo usuário


    ## Identidade do Inquilino

    Em produção, a identidade do inquilino é derivada do contexto autenticado
    (chave de API ou JWT).

    O cabeçalho `X-Tenant-ID` é ignorado em produção para evitar falsificação.
  version: 1.0.0
  contact:
    name: Truthlocks Support
    url: https://truthlocks.com/support
    email: support@truthlocks.com
servers:
  - url: https://api.truthlocks.com
    description: API de Produção
  - url: https://sandbox-api.truthlocks.com
    description: Ambiente Sandbox
security:
  - APIKey: []
  - BearerAuth: []
tags:
  - name: Authentication
    description: Gerenciamento de chaves e tokens de API
  - name: Issuers
    description: Registro do emissor e gerenciamento de confiança
  - name: Keys
    description: Gerenciamento de chaves criptográficas para emissores
  - name: Attestations
    description: Ciclo de vida da atestação (cunhar, revogar, substituir)
  - name: Verification
    description: Verificação de atestado e pacotes de prova
  - name: Governance
    description: Fluxos de trabalho de governança do emissor (somente administrador)
  - name: Identity
    description: Gerenciamento de organização, usuário e função
  - name: Audit
    description: Consultas de eventos de auditoria
  - name: Tenant Console
    description: Endpoints de perfil e ciclo de vida do locatário
  - name: Health
    description: Endpoints de saúde e prontidão do serviço
  - name: Risk
    description: Ingestão de sinal de risco e detecção de fraude
  - name: Risk Enforcement
    description: Ações de aplicação de risco — bloqueio, desafio, quarentena e configuração
  - name: Billing
    description: Gerenciamento de faturamento, assinatura e complementos
  - name: Machine Identity
    description: >-
      Protocolo de Identidade de Agente de Máquina (MAIP) — registro de agente,
      sessões, confiança, testemunha, conformidade, orquestração e
      observabilidade
externalDocs:
  description: API somente leitura de transparência (especificação de serviço separada)
  url: >-
    https://github.com/truthlocks/truthlock/blob/main/docs/transparency/openapi.yaml
paths:
  /v1/truth/claim:
    post:
      tags:
        - Machine Identity
      summary: Criar Declaração de Verdade
      description: >-
        Cria uma nova declaração de verdade com evidências de suporte. Um recibo
        é gerado para auditabilidade e a declaração entra em um pipeline de
        verificação.
      operationId: maip.truth.create
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                agent_id:
                  type: string
                  description: Agente reivindicador
                  format: uuid
                claim_type:
                  type: string
                  description: >-
                    Classificação da reivindicação (por exemplo, data_integrity,
                    model_accuracy)
                claim_value:
                  type: string
                confidence:
                  type: number
                evidence_refs:
                  type: array
                  items:
                    type: string
                metadata: {}
                methodology:
                  type: string
              type: object
              required:
                - claim_type
                - claim_value
                - agent_id
      responses:
        '201':
          description: Reivindicação de verdade criada
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MaipTruthClaim'
        '400':
          description: Erro de validação
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '401':
          description: Autenticação necessária
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '429':
          description: Limite de taxa excedido
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      security:
        - APIKey: []
components:
  schemas:
    MaipTruthClaim:
      type: object
      properties:
        claim_id:
          type: string
          format: uuid
        agent_id:
          type: string
          format: uuid
        claim_type:
          type: string
        payload:
          type: object
          additionalProperties: true
        evidence:
          type: array
          items:
            type: object
            additionalProperties: true
        status:
          type: string
          enum:
            - pending
            - verified
            - rejected
            - expired
        receipt_id:
          type: string
          format: uuid
        attestations:
          type: array
          items:
            $ref: '#/components/schemas/MaipAttestation'
        verified_at:
          type: string
          format: date-time
        created_at:
          type: string
          format: date-time
    ErrorEnvelope:
      type: object
      required:
        - code
        - message
        - http_status
      properties:
        code:
          type: string
          description: Código de erro legível por máquina
          enum:
            - AUTH_REQUIRED
            - AUTH_INVALID
            - PERMISSION_DENIED
            - TENANT_IDENTITY_UNVERIFIED
            - NOT_FOUND
            - VALIDATION_ERROR
            - CONFLICT
            - PAYLOAD_TOO_LARGE
            - RATE_LIMIT_EXCEEDED
            - QUOTA_EXCEEDED
            - SERVICE_UNAVAILABLE
            - INTERNAL_ERROR
        message:
          type: string
          description: Mensagem de erro legível por humanos
        http_status:
          type: integer
          description: Código de status HTTP
        retry_after_ms:
          type: integer
          description: >-
            Milissegundos para aguardar antes de tentar novamente (para limites
            de taxa)
        details:
          type: object
          description: Contexto de erro adicional
      example:
        code: AUTH_REQUIRED
        message: Authentication required
        http_status: 401
    MaipAttestation:
      type: object
      properties:
        attestation_id:
          type: string
          format: uuid
        witness_id:
          type: string
          format: uuid
        agent_id:
          type: string
          format: uuid
        claim_hash:
          type: string
        signature:
          type: string
        status:
          type: string
          enum:
            - pending
            - accepted
            - rejected
        created_at:
          type: string
          format: date-time
  securitySchemes:
    APIKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: Chave de API para autenticação máquina a máquina
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT para operações iniciadas pelo usuário

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.