List Team Members

List the agents who belong to a team, ordered by name. Membership is intersected with the workspace's current roster, so a user who has left the workspace is omitted even though the team still carries the row — they can no longer be assigned work. pagination.total counts that intersection, not the raw membership rows. Every operation is scoped by the required workspaceId. A workspace-scoped API key that names any other workspace is refused with 403 before any query runs, so a workspace key can only ever reach its own workspace. A team in another workspace is reported as 404, never as denied.

GET/api/v1/chat/teams/{teamId}/members

Authorization

apiKey
X-API-Key<token>

Your Studio API key, personal or workspace-scoped. Generate one under Settings, then API Keys. Operations that reject workspace keys say so in their own description.

In: header

Path Parameters

teamId*string

Team whose members are listed.

Length1 <= length

Query Parameters

page?integer

1-based page number. Defaults to 1.

Default1
Range1 <= value <= 9007199254740991
perPage?integer

Items per page, between 1 and 100. Defaults to 25.

Default25
Range1 <= value <= 100
workspaceId*string

Workspace the team belongs to.

Length1 <= length

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://agent-studio.seeyu.ai/api/v1/chat/teams/string/members?workspaceId=string" \  -H "X-API-Key: YOUR_API_KEY"
{
  "members": [
    {
      "userId": "usr_01J8F2K3N5PA",
      "name": "Marcos Lima",
      "image": null
    }
  ],
  "pagination": {
    "page": 1,
    "perPage": 25,
    "total": 1,
    "totalPages": 1
  }
}
{
  "error": "Invalid input: expected string, received undefined",
  "details": [
    {
      "code": "invalid_type",
      "expected": "string",
      "path": [
        "phone"
      ],
      "message": "Invalid input: expected string, received undefined"
    }
  ]
}
{
  "error": "Unauthorized"
}
{
  "error": "API key is not authorized for this workspace"
}
{
  "error": "Conversation not found"
}
{
  "error": "Rate limit exceeded",
  "message": "API rate limit exceeded. Please retry after 2026-09-13T12:00:00.000Z",
  "retryAfter": 1789286400000
}
{
  "error": "Internal server error",
  "requestId": "req_01J9Z2K3M4N5P6Q7R8S9T0"
}
GETList ContactsGETList Teams