워크스페이스 멤버 조회

플랜: Business 이상

스코프: workspaces:read

활성 워크스페이스 멤버의 프로필과 참여·초대 날짜를 반환합니다. name은 저장된 표시 이름이며 사용할 수 없으면 null입니다. GET /v1/workspaces/{workspace_id}/members가 user_id로 반환한 공개 사용자 UUID를 전달하세요. 알 수 없는 사용자와 존재하지 않거나 활성 상태가 아닌 멤버십은 404를 반환합니다. 읽기는 eventually consistent이므로 최근 변경이 즉시 나타나지 않을 수 있습니다. 예상한 변경이 보이지 않으면 백오프를 두고 다시 읽으세요.

OpenAPI

GET /v1/workspaces/{workspace_id}/members/{user_id}

인증

Lovable-API-Key: lov_your-api-key 또는 Authorization: Bearer <key>를 보냅니다. 이 엔드포인트는 workspaces:read 스코프가 필요합니다. workspaces:write는 workspaces:read를 포함하지만 프로젝트 계열 스코프는 워크스페이스 계열로 넘어가지 않습니다. 키는 하나의 워크스페이스에 바인딩되므로 다른 워크스페이스의 리소스는 존재하지 않는 리소스와 마찬가지로 404를 반환합니다. 응답 본문이 있으면 application/json을 반환합니다. Accept: application/json이나 Accept: */*를 보내거나 Accept 헤더를 생략하세요. JSON을 제외하는 Accept 헤더는 406을 반환합니다.

매개변수

이 작업은 query 매개변수와 요청 본문을 받지 않습니다.

예시

curl --request GET \
  --url 'https://api.lovable.dev/v1/workspaces/workspace-id/members/user-id' \
  --header 'Lovable-API-Key: lov_your-api-key' \
  --header 'Lovable-Version: 2026-09-11'

const response = await fetch("https://api.lovable.dev/v1/workspaces/workspace-id/members/user-id", {
  method: "GET",
  headers: {
    "Lovable-API-Key": process.env.LOVABLE_API_KEY ?? "lov_your-api-key",
    "Lovable-Version": "2026-09-11",
  },
});
if (!response.ok) {
  throw new Error(`Lovable API ${response.status}: ${await response.text()}`);
}
console.log(await response.json());

응답

오류 요구사항 metadata

이 읽기 작업에서 요구사항 metadata는 402와 403 응답의 props에만 나타납니다. 402 payment_required는 최소 플랜 tier를 담은 required_plan을 주거나, 기능 게이트일 때 required_features 배열을 주며 required_features의 식별자는 '모두' 충족해야 합니다. 두 key는 함께 오지 않으며 결제 실패에 따라 둘 다 없을 수 있습니다. 403 forbidden의 required_permissions는 대체 가능한 권한 집합의 배열이고 어느 한 집합의 권한을 '모두' 가지면 통과하므로 'AND 집합들의 OR'로 읽습니다. 403 insufficient_scope의 required_scopes는 허용되는 스코프 목록이며 그중 '아무거나' 하나로 충족됩니다. 이 엔드포인트에서는 workspaces:read가 그 목록에 해당하고 workspaces:write가 이를 포함합니다.

요구사항 metadata는 실패한 검사만 설명하며 작업의 모든 조건을 설명하지 않습니다. 다른 검사가 여전히 요청을 거부할 수 있고 metadata 자체가 생략될 수도 있습니다. 권한·기능 식별자는 실질적 접근 범위를 설명하며 필요한 워크스페이스 역할을 확정하지 않으므로 접근 권한이 필요하면 워크스페이스 관리자에게 문의하세요. 식별자는 시간이 지나며 추가될 수 있습니다. 내부 전용 요구사항과 리소스를 감추는 응답은 접근 요구사항을 공개하지 않습니다.

응답 헤더

헤더는 상태별로 범위가 다릅니다. WWW-Authenticate는 401에만, Retry-After는 429에만 나타납니다. Lovable-Version과 Lovable-Beta는 200, 400, 404, 406, 503, default에 선언되고 401, 402, 403, 429에는 선언되지 않습니다. X-Request-Id, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-Lovable-Unknown-Query-Params, X-Lovable-Unknown-Query-Params-Omitted는 모든 상태에 공통으로 선언됩니다. 아래 표는 상태별 선언을 그대로 옮긴 것입니다.

스키마

필드 이름과 enum 값은 OpenAPI contract의 식별자를 그대로 유지했고 설명만 한국어로 옮겼습니다. null이 타입에 포함된 필드는 값이 없을 수 있습니다. 필수 여부는 각 schema 자신의 required 목록만 따릅니다.

WorkspaceMemberDetails

활성 워크스페이스 멤버입니다.

ErrorResponse

공통 오류 응답입니다. 작업에 따라 특정 상태 코드에 다른 응답 본문이 문서화될 수 있습니다. 예를 들어 멤버별 credit 한도 일괄 업데이트 결과가 해당됩니다.

원본에 인라인으로 포함됐던 이 작업의 OpenAPI 스냅샷은 YAML 스냅샷 (SHA-256: f555724451d02865e8c7530f08d6aceca34294bc4687d9ed955440a8ee98052e)으로 보존했습니다. 최신 전체 OpenAPI 계약은 https://api.lovable.dev/v1/openapi.yaml에서 확인할 수 있습니다.

관련 주제

• 워크스페이스 조회
• 워크스페이스 보안 인사이트 조회
• People 탭에서 워크스페이스 멤버 관리
• 워크스페이스 멤버 목록 조회
• Lovable 프로젝트 게시