멤버 목록

MCP 도구

list_workspace_membersList Workspace Members

요청 제한

Default

API 권한

workspace-members:read

워크스페이스의 멤버 목록을 조회합니다.

예시

curl 'https://api.youvico.com/api/workspace/members' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "data": [
    {
      "id": "3d9f1c52-7e4a-4b8e-9f2d-6a1b0c8e5d47",
      "role": "WORKSPACE_OWNER",
      "status": "ACTIVE",
      "avatarUrl": "https://cdn.youvico.com/users/f6035d1a-29df-4d80-8d72-f1bbdddfb6ff/A1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6.avif",
      "displayName": "Jin",
      "position": "Producer",
      "user": {
        "id": "f6035d1a-29df-4d80-8d72-f1bbdddfb6ff",
        "name": "Jin Seo",
        "email": "jin@example.com"
      },
      "createdAt": "2026-03-02 04:15:27.604912"
    }
  ]
}

요청

파라미터는 없습니다.

응답

200 OK를 반환합니다.

dataarray

워크스페이스 멤버

data[].idstring

워크스페이스 멤버 ID

Example: 3d9f1c52-7e4a-4b8e-9f2d-6a1b0c8e5d47

data[].rolestring

워크스페이스 역할

Possible values: WORKSPACE_OWNERWORKSPACE_MANAGERWORKSPACE_MEMBERWORKSPACE_RESTRICTED_MEMBER

Example: WORKSPACE_OWNER

data[].statusstring

멤버 상태

Possible values: ACTIVESUSPENDED

Example: ACTIVE

data[].avatarUrlstring?

워크스페이스 아바타 URL. 없으면 계정 아바타 URL

Example: https://cdn.youvico.com/users/f6035d1a-29df-4d80-8d72-f1bbdddfb6ff/A1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6.avif

data[].displayNamestring?

워크스페이스 표시 이름

Example: Jin

data[].positionstring?

워크스페이스 직책

Example: Producer

data[].userobject

사용자 계정

data[].user.idstring

사용자 ID

Example: f6035d1a-29df-4d80-8d72-f1bbdddfb6ff

data[].user.namestring

계정 이름

Example: Jin Seo

data[].user.emailstring

계정 이메일

Example: jin@example.com

data[].createdAtstring

워크스페이스 참여 일시

Example: 2026-03-02 04:15:27.604912