> ## 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, com o id da conversa e o cliente no corpo.



## OpenAPI

````yaml openapi/pt/cell.json POST /v1/history/open
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/history/open:
    post:
      tags:
        - read
      summary: Abrir um item
      description: >-
        O mesmo que `GET /v1/history/items/{item_id}`, com o id da conversa e o
        cliente no corpo, nunca na URL.


        **Autenticação.** Chave de fonte: `Authorization: Bearer nia_sk_...`.
        Escopo exigido: `search`.
      operationId: open_item_by_body_v1_history_open_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenItemRequest'
            example:
              item_id: episode:0192f7a3-7c32-7b0c-9e16-5b8a0f1c2d34
              verification: V1
              conversation_id: call-4471
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenedItem'
              example:
                id: episode:0192f7a3-7c32-7b0c-9e16-5b8a0f1c2d34
                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: []
                as_of: '2026-09-22T17:07:02Z'
          description: O item aberto, como `GET /v1/history/items/{item_id}` devolve.
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: O pedido não bate com o contrato.
      security:
        - sourceKey: []
      x-codeSamples:
        - lang: python
          label: Python
          source: >-
            item = niadra.open("episode:0192f7a3-7c32-7b0c-9e16-5b8a0f1c2d34",
            conversation_id="call-4471")

            if item:
                print(item.summary, item.resolution)
        - lang: typescript
          label: TypeScript
          source: >-
            const { data: item } = await
            niadra.open("episode:0192f7a3-7c32-7b0c-9e16-5b8a0f1c2d34", {
            conversation_id: "call-4471" });

            if (item) console.log(item.summary, item.resolution);
components:
  schemas:
    OpenItemRequest:
      additionalProperties: false
      description: >-
        `GET /v1/history/items/{item_id}` com o id da conversa e o cliente no
        corpo.
      properties:
        conversation_id:
          anyOf:
            - maxLength: 512
              minLength: 1
              type: string
            - type: 'null'
          title: Conversation Id
        item_id:
          maxLength: 512
          minLength: 1
          title: Item Id
          type: string
        profile_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
          title: Profile Id
        subject:
          anyOf:
            - $ref: '#/components/schemas/Handle'
            - type: 'null'
        verification:
          $ref: '#/components/schemas/Verification'
          default: V0
      required:
        - item_id
      title: OpenItemRequest
      type: object
    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.
        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
    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
    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
    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
    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.
  securitySchemes:
    sourceKey:
      type: http
      scheme: bearer
      description: nia_sk_...

````