> ## 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. # Abrir um item > Uma conversa ou um objeto aberto: o que foi pedido, as promessas, o desfecho e o que nasceu dele. ## OpenAPI ````yaml openapi/pt/cell.json GET /v1/history/items/{item_id} 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/items/{item_id}: get: tags: - read summary: Abrir um item description: >- Uma conversa ou um objeto de negócio aberto: o que foi pedido, o que foi prometido e por quem, o desfecho e os itens de memória que nasceram dele, de forma estruturada. O trecho literal exige um escopo elevado. **Autenticação.** Chave de fonte: `Authorization: Bearer nia_sk_...`. Escopo exigido: `search`. operationId: open_item_v1_history_items__item_id__get parameters: - in: path name: item_id required: true schema: title: Item Id type: string - in: query name: profile_id required: false schema: anyOf: - format: uuid type: string - type: 'null' title: Profile Id - 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 está consultando, para valer o nível de verificação daquela sessão. responses: '200': content: application/json: schema: $ref: '#/components/schemas/OpenedItem' example: id: ep_01J2 kind: episode summary: Technician did not show up for the scheduled visit. requested: A new visit and compensation promises: - by: company what: New visit on Mar 13, morning due_at: '2026-03-13T15:00:00Z' status: kept outcome: resolved resolution: $40 credit on the April bill derived: [] timeline: [] excerpt: null as_of: '2026-09-22T17:07:02Z' description: O item aberto. '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: |- item = niadra.open("ep_01J2", conversation_id="call-4471") if item: print(item.summary, item.resolution) - lang: typescript label: TypeScript source: >- const { data: item } = await niadra.open("ep_01J2", { conversation_id: "call-4471" }); if (item) console.log(item.summary, item.resolution); 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 OpenedItem: additionalProperties: false properties: as_of: anyOf: - format: date-time type: string - type: 'null' title: As Of derived: items: $ref: '#/components/schemas/HistoryItem' title: Derived type: array description: Os itens de memória que nasceram desta conversa ou deste objeto. excerpt: anyOf: - type: string - type: 'null' description: >- Trecho literal da transcrição. Exige um escopo elevado e nunca é devolvido a uma audiência de voz. title: Excerpt id: title: Id type: string kind: enum: - episode - object title: Kind type: string outcome: anyOf: - type: string - type: 'null' title: Outcome promises: items: $ref: '#/components/schemas/Promise' title: Promises type: array requested: anyOf: - type: string - type: 'null' title: Requested resolution: anyOf: - type: string - type: 'null' title: Resolution summary: title: Summary type: string timeline: items: $ref: '#/components/schemas/HistoryItem' title: Timeline type: array required: - id - kind - summary title: OpenedItem 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 Promise: additionalProperties: false properties: by: enum: - company - customer title: By type: string due_at: anyOf: - format: date-time type: string - type: 'null' title: Due At status: title: Status type: string what: title: What type: string required: - by - what - status title: Promise type: object securitySchemes: sourceKey: type: http scheme: bearer description: nia_sk_... ````