> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jurichat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Galeria de mídia

> Lista as mídias já trocadas, da mais recente para a mais antiga.

O alcance é o mesmo da listagem de conversas: escritório do token, inboxes das quais quem pediu participa, conversa privada só quando ele é participante e restrição por setor quando o usuário só enxerga o que lhe é atribuído. Mensagem apagada não aparece.



## OpenAPI

````yaml https://api.jurichat.com/docs/client/openapi.json get /conversation/media-library
openapi: 3.1.0
info:
  title: JuriChat API — Documentação para Integradores
  description: ''
  version: 1.0.0
servers:
  - url: https://api.jurichat.com
    description: Production server
security:
  - apiKeyAuth: []
tags: []
paths:
  /conversation/media-library:
    get:
      tags:
        - Conversations
      summary: Galeria de mídia
      description: >-
        Lista as mídias já trocadas, da mais recente para a mais antiga.


        O alcance é o mesmo da listagem de conversas: escritório do token,
        inboxes das quais quem pediu participa, conversa privada só quando ele é
        participante e restrição por setor quando o usuário só enxerga o que lhe
        é atribuído. Mensagem apagada não aparece.
      parameters:
        - schema:
            type: string
            pattern: ^[cC][^\s-]{8,}$
          in: query
          name: conversationId
          required: false
          description: >-
            Restringe a galeria a uma conversa. Ausente, devolve a mídia de
            todas as conversas visíveis para quem pediu.
        - schema:
            type: string
            enum:
              - image
              - video
              - document
              - audio
              - sticker
          in: query
          name: type
          required: false
          description: Categoria de mídia. Ausente, devolve todas.
        - schema:
            type: string
            enum:
              - INBOUND
              - OUTBOUND
          in: query
          name: direction
          required: false
          description: >-
            Direção da mensagem: `OUTBOUND` é o que o escritório enviou,
            `INBOUND` o que o contato mandou. Ausente, devolve as duas.
        - schema:
            type: string
            minLength: 1
            maxLength: 100
          in: query
          name: search
          required: false
          description: Termo buscado no nome do arquivo e na legenda.
        - schema:
            type: string
            pattern: ^[cC][^\s-]{8,}$
          in: query
          name: cursor
          required: false
          description: '`nextCursor` da página anterior.'
        - schema:
            type: integer
            minimum: 1
            maximum: 100
          in: query
          name: limit
          required: false
          description: Itens por página. Padrão 24, máximo 100.
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        messageId:
                          type: string
                        conversationId:
                          type: string
                        conversationName:
                          type: string
                          description: Nome do contato ou do grupo dono da conversa.
                        type:
                          type: string
                          description: '`type` cru da mensagem (image, myaudio, ...).'
                        category:
                          type: string
                          enum:
                            - image
                            - video
                            - document
                            - audio
                            - sticker
                          description: >-
                            Categoria normalizada, usada pelos filtros do
                            painel.
                        direction:
                          type: string
                          enum:
                            - INBOUND
                            - OUTBOUND
                        messageAt:
                          type: string
                          format: date-time
                        url:
                          type: string
                          description: URL assinada do arquivo.
                        fileName:
                          type: string
                          nullable: true
                        caption:
                          type: string
                          nullable: true
                        fileExtension:
                          type: string
                          nullable: true
                        mimeType:
                          type: string
                          nullable: true
                        userName:
                          type: string
                          nullable: true
                          description: >-
                            Atendente que enviou. Nulo em mensagem recebida ou
                            do bot.
                      required:
                        - messageId
                        - conversationId
                        - conversationName
                        - type
                        - category
                        - direction
                        - messageAt
                        - url
                        - fileName
                        - caption
                        - fileExtension
                        - mimeType
                        - userName
                      additionalProperties: false
                  nextCursor:
                    type: string
                    nullable: true
                    description: >-
                      Passe em `cursor` para a próxima página. Nulo no fim da
                      lista.
                required:
                  - data
                  - nextCursor
                additionalProperties: false
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  statusCode:
                    type: number
                  code:
                    type: string
                  details:
                    anyOf:
                      - type: string
                      - type: number
                      - type: boolean
                      - type: object
                        properties: {}
                        additionalProperties: true
                    description: Detalhes adicionais do erro.
                required:
                  - message
                  - statusCode
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  statusCode:
                    type: number
                  code:
                    type: string
                  details:
                    anyOf:
                      - type: string
                      - type: number
                      - type: boolean
                      - type: object
                        properties: {}
                        additionalProperties: true
                    description: Detalhes adicionais do erro.
                required:
                  - message
                  - statusCode
                additionalProperties: false
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-jurichat-api-key
      description: >-
        Chave de API do escritório (criada no painel). Envie o valor no header
        x-jurichat-api-key.

````