---
title: "List Conversations"
method: GET
path: "/agents/{agent_id}/conversations"
tags: ["agents"]
---

# List Conversations

`GET /agents/{agent_id}/conversations`

## Request

- Base URL: `https://studio-api.meganova.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://studio-api.meganova.ai/agents/{agent_id}/conversations`
- Auth: OAuth 2
  - Password
  - Token URL: `auth/token`

List conversations for an agent.

## Path parameters

- `agent_id` string, uuid, required

## Query parameters

- `user_identifier` string, nullable
- `channel_type` string, nullable
- `page` integer
- `page_size` integer

## Response `200`

Successful Response

- AgentConversationListResponse: List of conversations.
  - `conversations` AgentConversationResponse[], required
    - `id` string, uuid, required
    - `agent_id` string, uuid, required
    - `chat_session_id` string, uuid, nullable
    - `user_identifier` string, nullable
    - `user_identifier_type` string, nullable
    - `channel_type` string, nullable
    - `summary` string, nullable
    - `key_topics` string[], nullable
    - `sentiment` string, nullable
    - `message_count` integer, required
    - `duration_seconds` integer, nullable
    - `satisfaction_rating` integer, nullable
    - `was_escalated` boolean, required
    - `was_resolved` boolean, nullable
    - `started_at` string, date-time, required
    - `ended_at` string, date-time, nullable
    - `last_message_at` string, date-time, nullable
  - `total` integer, required
  - `page` integer, required
  - `page_size` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/meganova/apis/meganova-api.md) - [All operations](https://skmtc.dev/meganova/apis/meganova-api/llms.txt) - [OpenAPI document](https://skmtc.dev/meganova/apis/meganova-api/revisions/c683584f6060?raw)