---
title: "Obter conversa"
method: GET
path: "/conversations/{id}"
tags: ["Conversations"]
---

# Obter conversa

`GET /conversations/{id}`

Recupera as mensagens de uma conversa.

## Path parameters

- `id` string, required

## Response `200`

Successful response

- object
  - `id` string, required — Identificador da conversa
  - `title` string, required — Título
  - `createdAt` string, date-time — Data de criação
  - `status` 'active' | 'finished' — Status
  - `summary` string, nullable — Resumo da conversa
  - `messages` object[] — 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" } ] ```
    - `id` string, required — Identificador da mensagem
    - `conversationId` string, required — Identificador da conversa
    - `role` 'system' | 'assistant' | 'user' | 'tool' | 'function', required — Define quem está enviando a mensagem
    - `name` string, nullable — Nome do participante da conversa
    - `content` string, nullable — Conteúdo da mensagem
    - `toolCallId` string, nullable — Identificador da chamada de ferramenta associada
    - `toolCalls` object[], nullable — Lista de chamadas de ferramentas associadas à mensagem
      - `id` string, required — Identificador único da chamada de ferramenta
      - `type` 'function', required — Tipo da chamada, sempre `function`
      - `function` object, required — Chamada de função
        - `name` string, required — Nome da função chamada pela ferramenta
        - `arguments` string, required — Argumentos fornecidos como entrada para a função
    - `metadata` object — Metadados adicionais da mensagem
    - `feedback` boolean, nullable — Feedback do usuário para a mensagem — `true` para positivo, `false` para negativo
    - `usage` object, required — Informações de uso
      - `promptTokens` number — Quantidade de tokens usados no prompt
      - `completionTokens` number — Quantidade de tokens usados na conclusão
      - `cachedTokens` number — Quantidade de tokens recuperados do cache
    - `attachments` object[], nullable — Anexos da mensagem
      - `type` 'image' | 'audio', required — Tipos de anexos
      - `url` string, required — URL do arquivo de mídia anexado
      - `content` string, nullable — Conteúdo adicional ao anexo
    - `createdAt` string, date-time — Data de criação
    - `updatedAt` string, date-time — Data da última atualização

## Other responses

- `default` — Error response

---

[API](https://skmtc.net/rdstationmentoria/apis/agents.md) · [All operations](https://skmtc.net/rdstationmentoria/apis/agents/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rdstationmentoria/agents/revisions/66aaaea086cc/schema)