v1
latestOpenAPI 3.0.02026-08-04891301.4 MBList 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
Example response
{
"data": [
{}
]
}