> ## Documentation Index > Fetch the complete documentation index at: https://docs.niadra.com/llms.txt > Use this file to discover all available pages before exploring further. # Histórico de um fato > Todo valor que o slot de um fato teve, com validade, origem e as arestas entre eles. ## OpenAPI ````yaml openapi/pt/cell.json GET /v1/profiles/{profile_id}/facts/{fact_id}/history openapi: 3.1.0 info: title: API de dados da Niadra version: '1' description: >- Escrita, contexto, histórico, objetos, identidade, privacidade e governança de um espaço. Cada espaço tem um endereço estável, com o espaço e a região no nome. servers: - url: https://{space}.{region}.api.niadra.com variables: space: default: acme-prod description: O espaço, que vem na chave de fonte. region: default: us-east-2 description: A região do espaço, que também vem na chave. security: [] paths: /v1/profiles/{profile_id}/facts/{fact_id}/history: get: tags: - governance summary: Histórico de um fato description: >- O que o slot de um fato teve antes e depois dele: os valores, quando cada um valeu, de onde cada um veio. **Autenticação.** Token de pessoa do Console com o papel `security`, `review`, `analysis` (ou admin), ou chave de fonte com o escopo `admin`. operationId: fact_history_v1_profiles__profile_id__facts__fact_id__history_get parameters: - in: path name: profile_id required: true schema: format: uuid title: Profile Id type: string - in: path name: fact_id required: true schema: format: uuid title: Fact Id type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/FactHistory' description: Resposta de sucesso. '422': content: application/problem+json: schema: $ref: '#/components/schemas/Problem' description: O pedido não bate com o contrato. security: - sourceKey: [] - personToken: [] components: schemas: FactHistory: additionalProperties: false description: >- `GET /v1/profiles/{profile_id}/facts/{fact_id}/history`: todo valor que um mesmo slot teve (o predicado, no mesmo handle e objeto), do mais antigo para o mais novo, com as arestas entre eles, sob a política de quem lê. properties: fact_id: title: Fact Id type: string policy_version: title: Policy Version type: string predicate: title: Predicate type: string profile_id: title: Profile Id type: string relations: items: $ref: '#/components/schemas/FactRelationOut' title: Relations type: array versions: items: $ref: '#/components/schemas/FactOut' title: Versions type: array withheld: additionalProperties: type: integer description: Versões deixadas de fora, por motivo. title: Withheld type: object required: - profile_id - fact_id - predicate - policy_version title: FactHistory type: object Problem: additionalProperties: false description: >- Detalhes do problema no formato da RFC 9457; `code` vem do catálogo de erros versionado. properties: code: title: Code type: string detail: anyOf: - type: string - type: 'null' default: null title: Detail request_id: anyOf: - type: string - type: 'null' default: null title: Request Id status: title: Status type: integer title: title: Title type: string type: default: about:blank title: Type type: string required: - title - status - code title: Problem type: object FactRelationOut: additionalProperties: false properties: from_fact_id: description: O fato mais novo. title: From Fact Id type: string origin: default: model description: >- Quem traçou a aresta: o `model` da extração, uma `rule` determinística (precedência, uma correção) ou a faixa de similaridade noturna (`band`), cujas arestas só avisam. enum: - model - rule - band title: Origin type: string to_fact_id: title: To Fact Id type: string type: description: '`supersedes` quando um valor substituiu outro, `contradicts`, ...' title: Type type: string required: - from_fact_id - to_fact_id - type title: FactRelationOut type: object FactOut: additionalProperties: false properties: about_handle_id: anyOf: - type: string - type: 'null' title: About Handle Id category: title: Category type: string confidence: title: Confidence type: number contradicts: description: Fatos em conflito com este, com quem achou o conflito. items: $ref: '#/components/schemas/FactContradictionOut' title: Contradicts type: array evidence_event_ids: items: type: string title: Evidence Event Ids type: array id: title: Id type: string invalid_at: anyOf: - format: date-time type: string - type: 'null' title: Invalid At last_confirmed_at: format: date-time title: Last Confirmed At type: string masked: default: false title: Masked type: boolean object: anyOf: - $ref: '#/components/schemas/ObjectRef' - type: 'null' origin: anyOf: - $ref: '#/components/schemas/Origin' - type: 'null' description: O evento de evidência mais antigo. predicate: title: Predicate type: string sensitivity: $ref: '#/components/schemas/Sensitivity' sessions_seen: anyOf: - type: integer - type: 'null' description: >- Conversas ou tarefas distintas cujos turnos sustentam o valor, o que o confirma; `times_seen` conta cada evidência nova. Nulo num fato antigo ainda não contado. title: Sessions Seen status: $ref: '#/components/schemas/FactStatus' times_seen: title: Times Seen type: integer unconfirmed_link: default: false description: >- Veio por um identificador que uma afirmação ligou ao perfil e ninguém confirmou ainda (`HandleOut.provisional`). Só os papéis `admin` e `security` veem esses itens; todo outro leitor, agentes incluídos, recebe o perfil sem eles até o vínculo ser confirmado. title: Unconfirmed Link type: boolean valid_at: format: date-time title: Valid At type: string value: anyOf: - type: string - type: 'null' description: Nulo quando a política mascara o valor para quem lê. title: Value required: - id - predicate - value - category - sensitivity - status - confidence - valid_at - last_confirmed_at - times_seen title: FactOut type: object FactContradictionOut: additionalProperties: false properties: fact_id: description: O outro fato do par. title: Fact Id type: string live: description: >- Os dois fatos continuam ativos. Retirar ou corrigir qualquer um dos dois fecha o par. title: Live type: boolean origin: description: >- `model` quando a extração marcou o conflito; `band` quando a comparação noturna dos fatos de um predicado o achou, sem modelo. Um par `band` é um aviso para a revisão: nunca muda um status, e cada fato pesa menos no contexto enquanto o par está vivo. enum: - model - rule - band title: Origin type: string required: - fact_id - origin - live title: FactContradictionOut type: object description: Um fato em conflito com o que foi lido, e quem achou o conflito. ObjectRef: additionalProperties: false description: Um objeto de negócio num sistema de registro. properties: id: maxLength: 512 minLength: 1 title: Id type: string description: O id nesse sistema. namespace: maxLength: 256 minLength: 1 title: Namespace type: string description: O sistema onde ele vive, como `erp`. type: maxLength: 256 minLength: 1 title: Type type: string description: Tipo do objeto, como `invoice`, `order` ou `ticket`. required: - type - namespace - id title: ObjectRef type: object Origin: additionalProperties: false description: >- A procedência de um item: o evento de onde veio, a fonte (agente ou sistema), o canal e a hora. properties: at: anyOf: - format: date-time type: string - type: 'null' title: At channel: anyOf: - type: string - type: 'null' title: Channel conversation_id: anyOf: - type: string - type: 'null' title: Conversation Id event_id: anyOf: - type: string - type: 'null' title: Event Id kind: anyOf: - $ref: '#/components/schemas/EventKind' - type: 'null' source_id: anyOf: - type: string - type: 'null' title: Source Id speaker: anyOf: - $ref: '#/components/schemas/Speaker' - type: 'null' task_id: anyOf: - type: string - type: 'null' title: Task Id title: Origin type: object Sensitivity: enum: - normal - restricted - sensitive title: Sensitivity type: string FactStatus: enum: - active - expired - quarantined - retracted title: FactStatus type: string EventKind: enum: - message - system_event - action title: EventKind type: string description: >- O que um evento registra: algo que foi dito, uma mudança num sistema de registro ou o que um agente fez num sistema. Speaker: enum: - customer - ai_agent - human_agent - system title: Speaker type: string description: Quem produziu o evento. securitySchemes: sourceKey: type: http scheme: bearer description: nia_sk_... personToken: type: http scheme: bearer bearerFormat: JWT ````