v1

latestOpenAPI 3.0.02026-08-04891301.4 MB

List agents in a thread

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.

get/api/v1/threads/{thread}/agents

Path parameters

threadstring required

Thread ID (thr_...). Must be a personal user thread visible to the authenticated user.

Response

Successful response

dataobject[] 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.

Example response

{
  "data": [
    {}
  ]
}