API

Appearance

워크스페이스›멤버

목록 Default ​

GET/workspaces/{id}/membersCopied!

워크스페이스 멤버 목록을 역할과 가입 순서 기준으로 조회해요.

접근 가능한 사용자

사용자

접근 권한

워크스페이스
워크스페이스 소유자워크스페이스 관리자워크스페이스 멤버워크스페이스 제한된 멤버

Request ​

Path ​

idstringrequired
워크스페이스 ID

Response ​

Returns 200 OK.

[]array
워크스페이스 멤버 목록
[].idstring
워크스페이스 멤버 ID

Example: 123e4567-e89b-12d3-a456-426614174000

[].rolestring
워크스페이스 역할

Possible values: WORKSPACE_OWNERWORKSPACE_MANAGERWORKSPACE_MEMBERWORKSPACE_RESTRICTED_MEMBER

Example: WORKSPACE_OWNER

[].statusstring
워크스페이스 멤버 상태

Possible values: ACTIVESUSPENDED

Example: ACTIVE

[].avatarstring?
멤버 아바타 경로
[].displayNamestring?
워크스페이스 표시 이름

Example: 홍길동

[].positionstring?
워크스페이스 직책

Example: 프로듀서

[].createdAtstring
멤버 등록 시각

Example: 2026-04-10 05:11:44.000000

[].userobject
연결된 사용자 정보
[].user.idstring
사용자 ID

Example: bdbff5de-96d7-468f-9db0-85fe28bd6b62

[].user.namestring
사용자 이름

Example: 홍길동

[].user.emailstring
사용자 이메일

Example: user@example.com

Example ​

bash
curl 'https://api.youvico.com/workspaces/6ba7b810-9dad-11d1-80b4-00c04fd430c8/members' \
  -H 'Authorization: Bearer xoau.aB3xK9p2QwR7sT4uV1nM8oP5qL6rN0yZ7eF2gH4jK...'
json
[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "role": "WORKSPACE_OWNER",
    "status": "ACTIVE",
    "avatar": null,
    "displayName": "홍길동",
    "position": "프로듀서",
    "createdAt": "2026-04-10 05:11:44.000000",
    "user": {
      "id": "bdbff5de-96d7-468f-9db0-85fe28bd6b62",
      "name": "홍길동",
      "email": "user@example.com"
    }
  }
]