> ## 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. # Linha do tempo > Conversas, eventos de sistema e ações em ordem, uma linha cada, pelo handle do cliente no corpo. ## OpenAPI ````yaml openapi/pt/cell.json POST /v1/history/timeline 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-1 description: A região do espaço, que também vem na chave. security: [] paths: /v1/history/timeline: post: tags: - read summary: Linha do tempo description: >- A história do cliente em ordem, da mais recente para a mais antiga: uma conversa, evento de sistema ou ação por linha, paginada. É `POST` porque o handle do sujeito é dado pessoal. **Autenticação.** Chave de fonte: `Authorization: Bearer nia_sk_...`. Escopo exigido: `search`. operationId: timeline_v1_history_timeline_post requestBody: content: application/json: schema: $ref: '#/components/schemas/TimelineRequest' example: subject: type: phone_e164 value: '+14155550123' filters: since: '2026-01-01T00:00:00Z' limit: 20 verification: V1 required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/TimelineResponse' example: items: - id: ep_01J2 kind: episode text: >- Technician did not show up · $40 credit on the April bill · settled at: '2026-03-12T14:20:00Z' channel: voice source_id: src_voice outcome: resolved confidence: 0.94 origin_event_id: evt_01J2A - id: ep_01J3 kind: episode text: Customer confirmed the credit and the new visit at: '2026-03-14T12:02:00Z' channel: whatsapp source_id: src_whatsapp outcome: resolved confidence: 0.91 origin_event_id: evt_01J3C next_cursor: c_01J8ZQ withheld: 1 as_of: '2026-09-22T17:07:02Z' description: Uma página. '422': content: application/problem+json: schema: $ref: '#/components/schemas/Problem' description: >- 422 `invalid_input`, `verification_not_allowed` ou `about_without_link`. security: - sourceKey: [] x-codeSamples: - lang: python label: Python source: |- page = niadra.timeline( phone("+14155550123"), filters={"since": "2026-01-01T00:00:00Z"}, limit=20, ) for item in page.items: print(item.at, item.kind, item.text) - lang: typescript label: TypeScript source: >- const { data: page } = await niadra.timeline({ subject: handles.phone("+14155550123"), filters: { since: "2026-01-01T00:00:00Z" }, limit: 20, }); for (const item of page?.items ?? []) console.log(item.at, item.kind, item.text); components: schemas: TimelineRequest: additionalProperties: false properties: about: anyOf: - $ref: '#/components/schemas/Handle' - type: 'null' conversation_id: anyOf: - maxLength: 512 minLength: 1 type: string - type: 'null' title: Conversation Id cursor: anyOf: - type: string - type: 'null' title: Cursor filters: $ref: '#/components/schemas/HistoryFilters' limit: default: 20 maximum: 100 minimum: 1 title: Limit type: integer subject: $ref: '#/components/schemas/Handle' verification: $ref: '#/components/schemas/Verification' default: V0 required: - subject title: TimelineRequest type: object TimelineResponse: additionalProperties: false properties: as_of: anyOf: - format: date-time type: string - type: 'null' title: As Of items: items: $ref: '#/components/schemas/HistoryItem' title: Items type: array next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor withheld: default: 0 title: Withheld type: integer required: - items title: TimelineResponse 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 Handle: additionalProperties: false description: >- Um identificador de um sujeito num canal ou sistema: um telefone, um e-mail, um id do CRM. properties: scope: anyOf: - maxLength: 256 minLength: 1 type: string - type: 'null' description: >- Espaço de nomes dos identificadores com escopo: a conta do WhatsApp Business para `wa_bsuid`, o sistema para `system_id`, o país para `gov_id_hmac`. title: Scope subject_kind: anyOf: - $ref: '#/components/schemas/SubjectKind' - type: 'null' description: >- O padrão é `person`, exceto nos tipos de handle que só identificam organizações. type: $ref: '#/components/schemas/HandleType' value: maxLength: 320 minLength: 1 title: Value type: string description: >- O identificador. Normalizado no servidor: E.164 para telefone, minúsculas para e-mail. required: - type - value title: Handle type: object HistoryFilters: additionalProperties: false properties: categories: items: maxLength: 256 minLength: 1 type: string title: Categories type: array channels: items: maxLength: 256 minLength: 1 type: string title: Channels type: array item_kinds: items: enum: - episode - fact - open_item - action - system_event - object - trait type: string title: Item Kinds type: array object: anyOf: - $ref: '#/components/schemas/ObjectRef' - type: 'null' outcome: anyOf: - maxLength: 256 minLength: 1 type: string - type: 'null' title: Outcome since: anyOf: - format: date-time type: string - type: 'null' title: Since until: anyOf: - format: date-time type: string - type: 'null' title: Until title: HistoryFilters type: object Verification: description: >- Nível de verificação da sessão. V0 autodeclarado, V1 plausível pelo canal, V2 atestado pelo canal, V3 desafiado (OTP ou login), V4 conferido com um sistema de registro ou por um atendente. `no_customer` vale para tarefas sem cliente presente e só é aceito de fontes de agente interno. enum: - V0 - V1 - V2 - V3 - V4 - no_customer title: Verification type: string HistoryItem: additionalProperties: false properties: at: format: date-time title: At type: string channel: anyOf: - type: string - type: 'null' title: Channel confidence: anyOf: - type: number - type: 'null' title: Confidence id: title: Id type: string kind: title: Kind type: string description: >- Um de `episode`, `fact`, `open_item`, `action`, `system_event`, `object`, `trait`. origin_event_id: anyOf: - type: string - type: 'null' title: Origin Event Id description: O evento de onde este item veio. outcome: anyOf: - type: string - type: 'null' title: Outcome source_id: anyOf: - type: string - type: 'null' title: Source Id text: title: Text type: string description: Texto denso, no mesmo estilo chave e valor do contexto. required: - id - kind - text - at title: HistoryItem type: object SubjectKind: enum: - person - account - partner title: SubjectKind type: string description: >- Uma pessoa, uma organização cliente (`account`) ou uma organização que participa sem ser cliente (`partner`). HandleType: enum: - phone_e164 - wa_id - wa_jid - wa_lid - wa_bsuid - email - gov_id_hmac - app_user_id - system_id - org_registry_hmac - email_domain - anon_id title: HandleType type: string description: >- O tipo de identificador. O valor é classificado pelo formato, nunca pelo campo de onde veio. 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 securitySchemes: sourceKey: type: http scheme: bearer description: nia_sk_... ````