> ## 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.

# Amostra de episódios

> Uma amostra redigida de episódios que atendem a um filtro.



## OpenAPI

````yaml openapi/pt/cell.json POST /v1/insights/episodes/sample
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/insights/episodes/sample:
    post:
      summary: Amostra de episódios
      description: >-
        Uma amostra redigida dos episódios que atendem a um filtro, para uma
        pessoa ou um LLM ler o que está por trás de um número.


        **Autenticação.** Chave de fonte com o escopo `analytics`, ou token de
        pessoa do Console com o papel analysis (ou admin). Pessoas do papel
        vendor não acessam.
      operationId: sample_episodes_v1_insights_episodes_sample_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SampleEpisodesRequest'
            example:
              since: '2026-09-01T00:00:00Z'
              until: '2026-09-22T23:59:59Z'
              filters:
                normalized_category:
                  - invoice
                outcome:
                  - resolved
              limit: 5
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SampleEpisodesResponse'
              example:
                items:
                  - pseudonym: psn_7f3a
                    episode_id: 0192f7a3-7c32-7b0c-9e16-5b8a0f1c2e10
                    channel: app
                    intent: dispute
                    category: invoice
                    outcome: resolved
                    sentiment: -0.4
                    ended_at: '2026-09-22T17:35:00Z'
                    summary: >-
                      Disputed the August bill after a missed visit; a credit
                      was applied by the billing agent.
                notice: >-
                  Redacted sample. Handles and free text with personal data are
                  removed.
          description: Os episódios da amostra, por pseudônimo.
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: O pedido não bate com o contrato.
      security:
        - sourceKey: []
components:
  schemas:
    SampleEpisodesRequest:
      additionalProperties: false
      properties:
        filters:
          additionalProperties:
            items:
              maxLength: 200
              type: string
            type: array
          title: Filters
          type: object
        limit:
          default: 10
          maximum: 50
          minimum: 1
          title: Limit
          type: integer
        since:
          format: date-time
          title: Since
          type: string
        until:
          format: date-time
          title: Until
          type: string
      required:
        - since
        - until
      title: SampleEpisodesRequest
      type: object
    SampleEpisodesResponse:
      additionalProperties: false
      properties:
        items:
          items:
            $ref: '#/components/schemas/EpisodeSampleOut'
          title: Items
          type: array
        notice:
          title: Notice
          type: string
      required:
        - items
        - notice
      title: SampleEpisodesResponse
      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
    EpisodeSampleOut:
      additionalProperties: false
      properties:
        category:
          title: Category
          type: string
        channel:
          title: Channel
          type: string
        ended_at:
          format: date-time
          title: Ended At
          type: string
        episode_id:
          format: uuid
          title: Episode Id
          type: string
        intent:
          title: Intent
          type: string
        outcome:
          title: Outcome
          type: string
        pseudonym:
          title: Pseudonym
          type: string
        sentiment:
          anyOf:
            - type: number
            - type: 'null'
          title: Sentiment
        summary:
          title: Summary
          type: string
      required:
        - pseudonym
        - episode_id
        - channel
        - intent
        - category
        - outcome
        - ended_at
        - summary
      title: EpisodeSampleOut
      type: object
  securitySchemes:
    sourceKey:
      type: http
      scheme: bearer
      description: nia_sk_...

````