---
title: "List agents in a thread"
method: GET
path: "/api/v1/threads/{thread}/agents"
---

# List agents in a thread

`GET /api/v1/threads/{thread}/agents`

Returns the agents participating in the specified thread. Only personal user
threads (threads owned by a single user, not a team) expose agents through
this endpoint; requests for team threads return 404.

The authenticated user must have visibility into the thread. Each agent entry
includes display information such as name and profile picture. Thread-level
overrides (e.g. a custom name or profile picture set for this thread) take
precedence over the agent's default values. When the caller is the thread
owner, each entry also includes an `agent_config` object describing the
agent's message policy and context configuration.

## Path parameters

- `thread` string, required

## Response `200`

Successful response

- object — The list of agents participating in the thread.
  - `data` object[], required — Array of agent objects for the thread. Each object includes `id`, `name`, `alias`, `profile_picture`, and `metadata`. Thread owners also receive an `agent_config` object with the agent's policy type and context configuration.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Thread not found

---

[API](https://skmtc.net/archastro/apis/archastro-platform-api.md) · [All operations](https://skmtc.net/archastro/apis/archastro-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/archastro/archastro-platform-api/versions/a8772b442f86/schema)