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

# Listar conversas

> Liste todas as conversas do usuário autenticado com suporte a paginação.



## OpenAPI

````yaml https://apigw.mka1.com/speakeasy.json?language=pt-BR get /api/v1/llm/conversations
openapi: 3.1.1
info:
  title: MKA1 API
  version: 1.1.0
  description: >-
    A API MKA1 é uma API RESTful que fornece acesso à plataforma MKA1. Aprenda
    como começar a usar a API e o SDK TypeScript
    [aqui](https://mka1.apidocumentation.com/guides/getting-started).
  license:
    name: Proprietário
servers:
  - url: https://apigw.mka1.com
    description: MKA1 API Gateway
  - url: /
    description: Relative server URL (configurable via SDK constructor)
security: []
tags:
  - name: Resource Authorization
    description: >-
      Gerencie permissões para recursos LLM. Crie recursos, conceda/revoque
      permissões e exclua recursos. Apenas os proprietários dos recursos podem
      conceder, revogar ou excluir permissões.
    x-displayName: Autorização de Recurso
  - name: Audit
    description: >-
      API de auditoria para proprietários e administradores da organização.
      Rastreie uma solicitação de ponta a ponta pelo seu X-Request-ID: tempo de
      processamento do gateway de API, as respostas que ele criou e suas
      invocações de modelo e chamadas de ferramenta.
    x-displayName: Auditoria
  - name: Embeddings
    description: >-
      Endpoints da API de incorporação de texto para gerar representações
      vetoriais de texto. Crie incorporações semânticas para busca, clustering e
      correspondência de similaridade usando vários modelos de incorporação.
    x-displayName: Incorporações
  - name: Feedback
    description: >-
      API de feedback do usuário para avaliar e comentar sobre as conclusões de
      chat. Coleta de classificações de positivo/negativo e feedback detalhado
      para melhorar as respostas do modelo e acompanhar a satisfação do usuário.
    x-displayName: Feedback
  - name: Images
    description: >-
      Pontos de extremidade da API de geração de imagens para criar imagens a
      partir de descrições de texto. Gere imagens com controle sobre tamanho,
      qualidade e estilo.
    x-displayName: Imagens
  - name: MCP Vault
    description: >-
      API do cofre MCP para armazenar configurações de servidor MCP de
      propriedade do usuário e credenciais criptografadas. Os agentes
      referenciam IDs de cofre para que os segredos sejam resolvidos apenas no
      momento da execução da ferramenta.
    x-displayName: Cofre MCP
  - name: Speech
    description: >-
      Pontos de extremidade da API de fala para processamento de áudio. Converta
      texto em fala com som natural (TTS) ou transcreva fala em texto (STT) em
      diferentes idiomas.
    x-displayName: Discurso
  - name: Usage
    description: >-
      API de rastreamento de uso e análise para monitoramento do consumo de
      tokens, contagem de solicitações e análise de custos. Veja estatísticas
      detalhadas por usuário, modelo e período de tempo.
    x-displayName: Uso
  - name: Extract
    description: >-
      API de extração de dados estruturados para extrair informações de
      arquivos. Defina esquemas JSON para extrair dados estruturados de imagens,
      PDFs e documentos. Suporta modelos de esquema reutilizáveis.
    x-displayName: Extração
  - name: Text Classification
    description: >-
      API de classificação de texto para categorizar textos em rótulos
      predefinidos. Use modelos de IA para classificar o conteúdo textual para
      análise de sentimento, categorização de tópicos e moderação de conteúdo.
    x-displayName: Classificação de Texto
  - name: Responses
    description: >-
      API de respostas com agentes para criar agentes de IA com uso autônomo de
      ferramentas. Crie assistentes conversacionais que possam usar busca na
      web, operações de arquivos, geração de imagens, execução de código e
      integrações MCP. Suporta processamento em segundo plano, streaming e
      acompanhamento de status em tempo real.
    x-displayName: Respostas
  - name: Files
    description: >-
      API de gerenciamento de arquivos para upload, armazenamento e
      gerenciamento de arquivos com expiração automática e integração com S3.
      Faça upload de arquivos que podem ser usados com Assistentes,
      Armazenamentos Vetoriais e outras funcionalidades. Os arquivos são
      armazenados no S3 com metadados rastreados no PostgreSQL. Suporta limpeza
      automática de arquivos expirados.
    x-displayName: Arquivos
  - name: Vector Stores
    description: >-
      API de armazenamento de vetores para armazenar e pesquisar documentos
      usando embeddings. Crie armazenamentos de vetores, faça upload de arquivos
      com divisão automática e geração de embeddings, e realize pesquisas
      semânticas. Os arquivos são processados de forma assíncrona usando fluxos
      de trabalho Temporais para durabilidade. Suporta limpeza automática de
      armazenamentos expirados e LanceDB para armazenamento eficiente de
      vetores.
    x-displayName: Armazenamentos de Vetores
  - name: Conversations
    description: >-
      API de gerenciamento de conversas para armazenar e recuperar o estado da
      conversa durante chamadas à API de Resposta. Crie conversas, adicione
      itens (mensagens do usuário, mensagens do assistente, mensagens do
      sistema) e mantenha o histórico da conversa. Suporta rastreamento de
      metadados e gerenciamento de estado de diálogo em múltiplas interações.
    x-displayName: Conversa
  - name: Guardrails
    description: >-
      API de diretrizes de segurança de IA para configurar moderação de conteúdo
      e políticas de segurança. Configure listas de palavras proibidas, detecção
      de injeção de prompts e prevenção de vazamento de prompts do sistema. As
      diretrizes aplicam-se a todas as solicitações de uma conta e podem ser
      testadas antes da implementação.
    x-displayName: Guarda-corpos
  - name: Models
    description: >-
      API de listagem de modelos para descobrir modelos disponíveis. Retorna IDs
      de modelos, propriedade e metadados de todos os modelos registrados no
      gateway.
    x-displayName: Modelos
  - name: Skills
    description: >-
      API de habilidades para gerenciar pacotes versionados de instruções e
      arquivos seguindo o padrão de Habilidades do Agente. Crie, versionar e
      baixe pacotes de habilidades reutilizáveis que incluam manifestos SKILL.md
      para ambientes de agentes.
    x-displayName: Habilidades
  - name: Chat Completions
    description: >-
      **Obsoleto: Use a API de Respostas (`/api/v1/llm/responses`) em vez
      disso.** Endpoints de conclusão de chat com suporte para streaming,
      chamadas de ferramentas e múltiplos provedores.
    x-deprecated: true
    x-displayName: Conclusões de Bate-Papo
  - name: Batches
    x-displayName: Lotes
  - name: Evals
    x-displayName: Avaliações
  - name: Fine-Tuning
    x-displayName: Ajuste Fino
  - name: Memory Stores
    x-displayName: Armazenamentos de Memória
  - name: Prompts
    x-displayName: Sugestões
  - name: API Key
    x-displayName: Chave da API
  - name: OAuth
    x-displayName: OAuth
  - name: Session
    x-displayName: Sessão
  - name: Organization
    x-displayName: Organização
  - name: Cluster Admin
    x-displayName: Administrador do cluster
  - name: Sessions
    description: Crie, inspecione, acesse e encerre sessões de sandbox.
    x-displayName: Sessões
  - name: Browser
    description: >-
      Conecte-se às sessões do navegador através do proxy da porta do gateway.
      As sessões do navegador expõem um endpoint do Chrome DevTools Protocol na
      porta 9222.
    x-displayName: Navegador
  - name: Execution
    description: >-
      Executar comandos shell e código dentro de uma sessão de sandbox
      existente.
    x-displayName: Execução
  - name: Workspace
    description: >-
      Inspecione o manifesto do espaço de trabalho, transfira arquivos ou
      arquivos compactados e baixe artefatos gerados.
    x-displayName: Espaço de trabalho
  - name: Sandbox Usage
    description: >-
      Agregue estatísticas de uso da sandbox entre sessões, execução e operações
      do espaço de trabalho.
    x-displayName: Uso do Sandbox
  - name: Sandbox Pricing
    description: >-
      Gerenciamento de cluster-admin da tabela de preços de computação da
      sandbox usada para gastos orçados.
    x-displayName: Preço da Sandbox
  - name: Sandbox GitHub
    description: >-
      Conecte uma conta do GitHub, clone seus repositórios em sessões do sandbox
      e envie branches e abra pull requests a partir de uma sessão. O token do
      GitHub permanece no serviço de sandbox e nunca entra em uma sessão.
    x-displayName: Sandbox do GitHub
  - name: Sandbox Environments
    description: >-
      Salvar a configuração de sessão reutilizável (repositórios, variáveis de
      ambiente, acesso à rede e um script de configuração) e executar o script
      de configuração em uma sessão.
    x-displayName: Ambientes de Sandbox
  - name: Sandbox Connectors
    description: >-
      Conecte servidores MCP remotos (Linear, Notion, Sentry e outros) à sua
      conta para que sessões do Coding Harness iniciadas a partir de um ambiente
      que os liste possam chamar as ferramentas deles. O serviço de sandbox
      mantém as credenciais de cada conector e nunca as coloca em uma sessão.
    x-displayName: Conectores de Sandbox
  - name: Agents
    description: Crie e gerencie definições de agentes reutilizáveis.
    x-displayName: Agentes
  - name: Agent Versions
    description: >-
      Inspecione o histórico de configuração de um agente e reverta para uma
      versão anterior.
    x-displayName: Versões do Agente
  - name: Agent Runs
    description: Execute agentes salvos e inspecione os resultados da execução persistidos.
    x-displayName: Executa Agente
  - name: Agent Connectors
    description: >-
      Conecte agentes salvos a canais de mensagens externos, como o Telegram,
      incluindo troca de texto, foto e documentos compatíveis.
    x-displayName: Conectores de Agente
  - name: Agent Schedules
    description: Crie e gerencie execuções de agentes salvos agendadas ou recorrentes.
    x-displayName: Agendas de Agentes
  - name: schema-4_other
    x-displayName: outro
  - name: Billing
    x-displayName: Cobrança
  - name: Budgets
    x-displayName: Orçamentos
  - name: Settings
    x-displayName: Configurações
  - name: Compute Jobs
    x-displayName: Jobs de Computação
  - name: Compute Services
    x-displayName: Serviços de Computação
  - name: Compute Catalog
    x-displayName: Catálogo de Computação
  - name: Compute Volumes
    x-displayName: Calcular volumes
  - name: Compute Pricing
    x-displayName: Calcular Preços
  - name: Compute Secrets
    x-displayName: Calcular Segredos
  - name: Compute Usage
    x-displayName: Uso de Computação
  - name: Compute Tenants
    x-displayName: Calcular Inquilinos
  - description: Criar, listar, ler, atualizar e excluir repositórios.
    name: Repositories
    x-displayName: Repositórios
  - name: Tracking Experiments
    description: Criar e consultar experimentos de locatário.
    x-displayName: Rastreamento de Experimentos
  - name: Tracking Runs
    description: Registrar e recuperar parâmetros, métricas e tags da execução.
    x-displayName: Acompanhamento de execuções
  - name: analytics.projects
    x-displayName: Projetos
    description: Criar, listar, renomear e arquivar projetos de análise.
  - name: analytics.keys
    x-displayName: Capturar chaves
    description: Criar e revogar chaves do projeto para enviar eventos.
  - name: analytics
    x-displayName: Eventos
    description: Envie eventos e consulte contagens de eventos ou visitantes únicos.
  - name: analytics.events
    x-displayName: Busca de eventos
    description: >-
      Liste eventos individuais com suas propriedades, do mais recente para o
      mais antigo.
  - name: analytics.visitors
    x-displayName: Busca de visitantes
    description: >-
      Liste os visitantes por sua atividade mais recente, com os horários de
      primeira e última visualização.
  - name: generators
    x-displayName: geradores
  - name: generations
    x-displayName: gerações
  - name: formats
    x-displayName: formatos
  - description: >-
      Flags, ambientes, avaliação e o log de auditoria. As operações
      administrativas exigem um administrador de cluster; a avaliação usa uma
      chave de avaliação específica do ambiente.
    name: Feature Flags
    x-displayName: Flags de Recursos
  - name: Service Status
    description: >-
      Status atual de cada serviço e o histórico de incidentes, para a região
      desta implantação.
    x-displayName: Status do Serviço
  - name: Support Cases
    description: >-
      Abra e acompanhe casos de suporte. Os proprietários e administradores da
      organização veem todos os casos da organização; os outros membros veem os
      casos que abriram.
    x-displayName: Casos de suporte
paths:
  /api/v1/llm/conversations:
    get:
      tags:
        - Conversations
      summary: Listar conversas
      description: Liste todas as conversas do usuário autenticado com suporte a paginação.
      operationId: conversations.list
      parameters:
        - name: after
          in: query
          schema:
            type: string
            description: >-
              ID da conversa para listar as conversas posteriores (cursor de
              paginação)
            examples:
              - conv_abc123
          allowEmptyValue: true
          example: conv_abc123
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 50
            default: 20
            description: Número máximo de conversas a retornar (1-50, padrão 20)
            examples:
              - 20
          allowEmptyValue: true
          example: 20
        - name: order
          in: query
          schema:
            enum:
              - asc
              - desc
            type: string
            default: asc
            description: >-
              Ordem de classificação pela última atualização: asc (mais antigo
              primeiro) ou desc (mais recente primeiro)
            examples:
              - desc
          allowEmptyValue: true
          example: desc
        - name: metadata
          in: query
          schema:
            anyOf:
              - type: string
              - type: object
                propertyNames:
                  type: string
                additionalProperties:
                  type: string
            description: >-
              Filtre conversas por pares de chave-valor de metadados (string ou
              objeto JSON). Apenas conversas com metadados correspondentes serão
              retornadas.
            examples:
              - user_type: premium
          allowEmptyValue: true
          example:
            user_type: premium
        - name: search
          in: query
          schema:
            type: string
            description: >-
              Consulta de pesquisa para encontrar conversas por conteúdo.
              Utiliza pesquisa de texto completo em itens de conversa.
            examples:
              - weather forecast
          allowEmptyValue: true
          example: weather forecast
        - name: X-On-Behalf-Of
          in: header
          required: false
          schema:
            type: string
          description: Optional external end-user identifier forwarded by the API gateway.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversationListObject'
              example:
                object: list
                data:
                  - id: conv_abc123
                    object: conversation
                    created_at: 1704067200
                    metadata:
                      session_id: sess_abc123
                      user_type: premium
                has_more: false
                last_id: conv_abc123
      security:
        - bearerAuth: []
      x-codeSamples:
        - lang: csharp
          label: CSharp (SDK)
          source: |-
            using MeetKai.MKA1;
            using MeetKai.MKA1.Types.Components;
            using MeetKai.MKA1.Types.Requests;
            using System.Collections.Generic;

            var sdk = new SDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");

            ConversationsListRequest req = new ConversationsListRequest() {
                After = "conv_abc123",
                Order = ConversationsListOrder.Desc,
                Metadata = MeetKai.MKA1.Types.Requests.Metadata.CreateMapOfStr(
                    new Dictionary<string, string>() {
                        { "user_type", "premium" },
                    }
                ),
                Search = "weather forecast",
            };

            var res = await sdk.Llm.Conversations.ListAsync(req);

            // handle response
        - lang: python
          label: Python (SDK)
          source: |-
            from meetkai_mka1 import SDK


            with SDK(
                bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
            ) as sdk:

                res = sdk.llm.conversations.list(after="conv_abc123", limit=20, order="desc", metadata={
                    "user_type": "premium",
                }, search="weather forecast")

                # Handle response
                print(res)
        - lang: typescript
          label: Typescript (SDK)
          source: |-
            import { SDK } from "@meetkai/mka1";

            const sdk = new SDK({
              bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
            });

            async function run() {
              const result = await sdk.llm.conversations.list({
                after: "conv_abc123",
                order: "desc",
                metadata: {
                  "user_type": "premium",
                },
                search: "weather forecast",
              });

              console.log(result);
            }

            run();
        - lang: go
          label: Go (SDK)
          source: "package main\n\nimport(\n\t\"context\"\n\tmka1 \"github.com/MeetKai/mka1-sdks/go\"\n\t\"github.com/MeetKai/mka1-sdks/go/models/operations\"\n\t\"log\"\n)\n\nfunc main() {\n    ctx := context.Background()\n\n    s := mka1.New(\n        mka1.WithSecurity(\"<YOUR_BEARER_TOKEN_HERE>\"),\n    )\n\n    res, err := s.Llm.Conversations.List(ctx, operations.ConversationsListRequest{\n        After: mka1.Pointer(\"conv_abc123\"),\n        Order: operations.ConversationsListOrderDesc.ToPointer(),\n        Metadata: mka1.Pointer(operations.CreateMetadataMapOfStr(\n            map[string]string{\n                \"user_type\": \"premium\",\n            },\n        )),\n        Search: mka1.Pointer(\"weather forecast\"),\n    })\n    if err != nil {\n        log.Fatal(err)\n    }\n    if res.ConversationListObject != nil {\n        // handle response\n    }\n}"
components:
  schemas:
    ConversationListObject:
      type: object
      properties:
        object:
          const: list
        data:
          type: array
          items:
            $ref: '#/components/schemas/ConversationObject'
          description: Array de conversas
        has_more:
          type: boolean
          description: Se há mais conversas
        last_id:
          type: string
          description: ID da última conversa na página atual
      required:
        - object
        - data
        - has_more
      examples:
        - object: list
          data:
            - id: conv_abc123
              object: conversation
              created_at: 1704067200
              metadata:
                session_id: abc123
          has_more: true
          last_id: conv_abc123
    ConversationObject:
      type: object
      properties:
        id:
          type: string
          description: O ID único da conversa
        object:
          const: conversation
          description: O tipo de objeto, sempre 'conversa'
        created_at:
          type: number
          description: Timestamp Unix de quando a conversa foi criada
        metadata:
          anyOf:
            - type: object
              propertyNames:
                type: string
                maxLength: 64
              additionalProperties:
                type: string
                maxLength: 512
            - type: 'null'
          description: >-
            Conjunto de 16 pares chave-valor. Chaves com no máximo 64
            caracteres, valores com no máximo 512 caracteres.
        identity:
          type: string
          description: >-
            Identidade do proprietário da conversa. Pode ser um hash SHA256 ou
            userId:externalUserId bruto, dependendo do MODO_DE_IDENTIDADE.
        deleted_at:
          anyOf:
            - type: number
            - type: 'null'
          description: >-
            Timestamp Unix de quando a conversa foi excluída suavemente, ou nulo
            se não foi excluída.
      required:
        - id
        - object
        - created_at
        - deleted_at
      examples:
        - id: conv_abc123
          object: conversation
          created_at: 1704067200
          metadata:
            session_id: abc123
            user_type: premium
          deleted_at: null
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        Send Authorization: Bearer <credential>, using an MKA1 API key for
        automation or an OAuth API access token for a signed-in application. Use
        a dynamic security callback to refresh OAuth access tokens. Browser
        session-only operations still require their declared cookie.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.