> ## 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 por perfil

> A mesma linha do tempo, pelo id do perfil na query.



## OpenAPI

````yaml openapi/pt/cell.json GET /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:
    get:
      tags:
        - read
      summary: Linha do tempo por perfil
      description: >-
        A mesma linha do tempo de `POST /v1/history/timeline`, pelo id do perfil
        na query, para ferramentas que já têm o perfil: uma conversa, evento de
        sistema ou ação por linha, do mais recente para o mais antigo, paginada
        por `cursor`. Mesma política, mesmo nível de verificação e mesmo
        comprovante.


        **Autenticação.** Chave de fonte: `Authorization: Bearer nia_sk_...`.
        Escopo exigido: `search`.
      operationId: timeline_by_profile_v1_history_timeline_get
      parameters:
        - in: query
          name: profile_id
          required: true
          schema:
            format: uuid
            title: Profile Id
            type: string
          description: O perfil cujo histórico será lido.
          example: 0192f7a1-5b10-7c3a-8e21-4d2f8a4c0e01
        - in: query
          name: cursor
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Cursor
          description: Cursor opaco, vindo de `next_cursor`.
        - in: query
          name: limit
          required: false
          schema:
            default: 20
            maximum: 100
            minimum: 1
            title: Limit
            type: integer
          example: 20
        - in: query
          name: verification
          required: false
          schema:
            $ref: '#/components/schemas/Verification'
            default: V0
        - in: query
          name: conversation_id
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Conversation Id
          description: >-
            A conversa que pergunta, para valer o nível de verificação daquela
            sessão.
      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: O pedido não bate com o contrato.
      security:
        - sourceKey: []
components:
  schemas:
    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
    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
    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
  securitySchemes:
    sourceKey:
      type: http
      scheme: bearer
      description: nia_sk_...

````