---
title: "Read Conversation Agents V1"
method: GET
path: "/agents/conversation-agents-v1"
tags: ["authenticated", "agents"]
---

# Read Conversation Agents V1

`GET /agents/conversation-agents-v1`

## Request

- Base URL: `https://api-docs.upsmith.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api-docs.upsmith.com/agents/conversation-agents-v1`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Lightweight V1-agent list for the conversations / simulations filter dropdown.

Sourced from the agent name stamped onto engagement metadata (not agent.agent),
so historical v1 agents keep appearing after the v1 agent tables are dropped.
Returns only v1 agents with at least one engagement eligible for the
requesting conversations or simulations list.

## Query parameters

- `is_simulated` boolean
- `hidden` boolean, nullable
- `group_by_customer` boolean

## Headers

- `organization-id` string, nullable
- `x-user-id` string, nullable
- `timezone` string
- `x-actor-email` string, nullable
- `x-request-source` string, nullable
- `x-operation-id` string, nullable
- `x-commit-message` string, nullable
- `x-confirmation-id` string, nullable
- `x-chat-id` string, nullable

## Response `200`

Successful Response

- ConversationAgentV1Response[]
  - `id` string, required
  - `title` string, required
  - `roster_name` string, nullable

## Other responses

- `422`: Validation Error

---

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