> ## Documentation Index > Fetch the complete documentation index at: https://docs.rdstationmentoria.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Obter conversa > Recupera as mensagens de uma conversa. ## OpenAPI ````yaml https://api.meuassistente.rdstationmentoria.com.br/rest get /conversations/{id} openapi: 3.0.3 info: title: Agents version: 0.0.1 servers: - url: https://api.meuassistente.rdstationmentoria.com.br/rest security: [] paths: /conversations/{id}: get: tags: - Conversations summary: Obter conversa description: Recupera as mensagens de uma conversa. operationId: conversations-get parameters: - name: id in: path required: true schema: type: string description: Identificador da conversa responses: '200': description: Successful response content: application/json: schema: type: object properties: id: type: string description: Identificador da conversa title: type: string description: Título createdAt: type: string format: date-time default: '2026-02-08T00:20:48.502Z' description: Data de criação status: type: string enum: - active - finished description: Status default: active summary: type: string nullable: true default: null description: Resumo da conversa messages: type: array items: type: object properties: id: type: string description: Identificador da mensagem conversationId: type: string description: Identificador da conversa role: type: string enum: - system - assistant - user - tool - function description: Define quem está enviando a mensagem name: type: string nullable: true default: null description: Nome do participante da conversa content: type: string nullable: true default: null description: Conteúdo da mensagem toolCallId: type: string nullable: true default: null description: Identificador da chamada de ferramenta associada toolCalls: type: array items: type: object properties: id: type: string description: Identificador único da chamada de ferramenta type: type: string enum: - function description: Tipo da chamada, sempre `function` function: type: object properties: name: type: string description: Nome da função chamada pela ferramenta arguments: type: string description: >- Argumentos fornecidos como entrada para a função required: - name - arguments additionalProperties: false description: Chamada de função required: - id - type - function additionalProperties: false description: Chamada de ferramenta nullable: true default: null description: >- Lista de chamadas de ferramentas associadas à mensagem metadata: type: object additionalProperties: {} default: {} description: Metadados adicionais da mensagem feedback: type: boolean nullable: true default: null description: >- Feedback do usuário para a mensagem — `true` para positivo, `false` para negativo usage: type: object properties: promptTokens: type: number description: Quantidade de tokens usados no prompt completionTokens: type: number description: Quantidade de tokens usados na conclusão cachedTokens: type: number description: Quantidade de tokens recuperados do cache additionalProperties: false description: Informações de uso attachments: type: array items: type: object properties: type: type: string enum: - image - audio description: Tipos de anexos url: type: string description: URL do arquivo de mídia anexado content: type: string nullable: true default: null description: Conteúdo adicional ao anexo required: - type - url additionalProperties: false description: Anexo de mensagem nullable: true default: [] description: Anexos da mensagem createdAt: type: string format: date-time default: '2026-02-08T00:20:48.503Z' description: Data de criação updatedAt: type: string format: date-time default: '2026-02-08T00:20:48.503Z' description: Data da última atualização required: - id - conversationId - role - usage additionalProperties: false default: [] description: > Histórico completo de mensagens trocadas nesta conversa, ordenadas cronologicamente. Cada mensagem possui: * `id`: identificador único da mensagem * `conversationId`: identificador da conversa à qual a mensagem pertence * `role`: quem falou (system, assistant, user, tool) * `name`: nome associado à mensagem, se aplicável * `content`: conteúdo textual da mensagem * `toolCallId`: identificador da chamada de ferramenta associada, se houver * `toolCalls`: lista de chamadas de ferramentas associadas, se houver * `metadata`: metadados adicionais em formato livre * `feedback`: indica se há feedback (booleano ou null) * `usage`: informações de uso, como tokens (se disponíveis) * `createdAt` e `updatedAt`: datas de criação e atualização da mensagem ### Exemplo de retorno ```json [ { "id": "msg_abc123", "conversationId": "convo_001", "role": "user", "name": "João", "content": "Olá, tudo bem?", "createdAt": "2025-07-08T14:30:00.000Z", "updatedAt": "2025-07-08T14:30:00.000Z" }, { "id": "msg_def456", "conversationId": "convo_001", "role": "assistant", "name": null, "content": "Olá! Como posso te ajudar?", "feedback": true, "usage": { "inputTokens": 6, "outputTokens": 9, "totalTokens": 15 }, "createdAt": "2025-07-08T14:30:02.000Z", "updatedAt": "2025-07-08T14:30:02.000Z" } ] ``` required: - id - title additionalProperties: false default: $ref: '#/components/responses/error' security: - Authorization: [] components: responses: error: description: Error response content: application/json: schema: type: object properties: message: type: string code: type: string issues: type: array items: type: object properties: message: type: string required: - message additionalProperties: false required: - message - code additionalProperties: false securitySchemes: Authorization: type: http scheme: bearer ````