프로젝트 목록 조회

Plan: Business or higher

Scope: workspaces:read

선택한 워크스페이스의 프로젝트를 하나의 cursor 페이지네이션 목록으로 반환합니다. 정렬은 last_edited_at 내림차순, 그다음 프로젝트 ID 오름차순입니다. 마지막 편집 시간이 없는 프로젝트는 업데이트 시간을 사용하고, 둘 다 없으면 마지막에 정렬됩니다. workspace_id를 반복해 최대 10개 워크스페이스를 선택할 수 있습니다. 선택한 모든 워크스페이스가 권한 검사를 통과해야 하며 하나라도 실패하면 전체 요청이 거부됩니다. 워크스페이스 범위 API 키는 자신의 워크스페이스로 제한됩니다. cursor는 선택한 워크스페이스 집합과 필터에 묶입니다. 읽기는 eventually consistent이므로 최근 변경 사항이 즉시 보이지 않을 수 있습니다. 기대한 변경 사항이 없으면 backoff를 두고 다시 읽으세요.

OpenAPI

항목	값
Method	`GET`
Path	`/v1/projects`
Operation ID	`listProjects`
Source spec	`https://api.lovable.dev/v1/openapi.yaml`
Local snapshot	YAML 스냅샷 (SHA-256: `444003f52c332be54cd432b0b4b5bc36907ce81d45aea052d95c55c8252c0859`)

GET /v1/projects

인증 및 media type

인증은 Lovable-API-Key header에 API 키를 보내거나 Authorization: Bearer <key> 형식으로 보냅니다.
키는 하나의 워크스페이스에 바인딩되고 public:v1 audience를 가집니다. 다른 워크스페이스의 리소스는 존재하지 않는 리소스와 마찬가지로 404를 반환합니다.
응답 본문이 있는 public:v1 엔드포인트는 application/json을 반환합니다. Accept: application/json, Accept: */*를 보내거나 Accept header를 생략하세요. JSON을 제외하는 Accept header는 406을 반환합니다.
쓰기 스코프는 대응하는 읽기 스코프를 포함합니다. projects:write는 projects:read를, workspaces:write는 workspaces:read를 포함합니다. 프로젝트 계열과 워크스페이스 계열 사이에는 권한이 넘어가지 않습니다.
목록 작업은 limit과 cursor를 받고 data와 pagination.next_cursor, pagination.has_more를 반환합니다. 다음 페이지는 next_cursor를 cursor로 전달해 가져옵니다. cursor는 opaque 값입니다.

매개변수

이름	위치	필수	타입	제약	설명
`workspace_id`	`query`	예	`array of string`	minItems: `1` maxItems: `10`	프로젝트를 조회할 워크스페이스 ID입니다. 매개변수를 반복해 최대 10개 워크스페이스를 선택할 수 있으며 중복은 무시됩니다. 호출자는 모든 워크스페이스에 접근할 수 있어야 합니다. 워크스페이스 범위 API 키는 자신의 워크스페이스만 선택할 수 있습니다.
`visibility`	`query`	아니요	`array of string`	enum: `restricted`, `workspace_edit`, `workspace_view`	`visibility` 필드로 필터링합니다. 여러 값 중 하나라도 일치하도록 매개변수를 반복할 수 있습니다. 접근 가능한 모든 수준을 포함하려면 생략하세요.
`is_published`	`query`	아니요	`boolean`	-	프로젝트 게시 여부로 필터링합니다. 필터링하지 않으려면 생략하세요.
`publish_audience`	`query`	아니요	`array of string`	enum: `public`, `workspace`, `custom`	게시된 프로젝트를 `publish_audience` 필드로 필터링합니다. 워크스페이스 기본값을 포함해 응답과 같은 방식으로 값을 해석합니다. 여러 값 중 하나라도 일치하도록 반복할 수 있습니다. 필터링하지 않으려면 생략하세요. `is_published`가 `true`이거나 생략되어야 합니다.
`query`	`query`	아니요	`string`	maxLength: `1000`	프로젝트 이름, 생성된 설명, 소유자 이름 또는 이메일 주소를 검색합니다. 3자보다 짧은 검색어는 무시됩니다.
`limit`	`query`	아니요	`integer`	default: `50` min: `1` max: `100` format: `int64`	페이지마다 반환할 최대 항목 수입니다.
`cursor`	`query`	아니요	`string`	-	다음 페이지를 가져오려면 이전 응답의 `pagination.next_cursor`를 전달합니다. 첫 페이지에서는 생략합니다. 페이지를 넘길 때 같은 필터와 정렬 순서를 유지하세요.
`Lovable-Version`	`header`	아니요	`string`	-	제공받을 안정 API 버전입니다. `YYYY-MM-DD` 날짜 형식으로 보냅니다. 생략하면 현재 가장 오래된 지원 안정 버전인 `2026-09-11`이 사용됩니다.
`Lovable-Beta`	`header`	아니요	`string`	-	안정 버전 위에 활성화할 베타 리비전 문자열입니다. 여러 개는 쉼표로 구분합니다.

요청 본문

요청 본문은 없습니다.

응답

상태	본문 schema	설명
`200`	`ProjectSummaryPage`	요청이 성공했습니다.
`400`	`ErrorResponse`	요청 본문이나 매개변수 형식이 잘못되었거나 검증에 실패했습니다. 실패한 각 필드는 `errors`에 나열됩니다.
`401`	`ErrorResponse`	API 키, session token, OAuth access token이 없거나 유효하지 않습니다.
`402`	`ErrorResponse`	Public API 접근에는 Business 이상 플랜이 필요합니다. 일부 작업이나 구성에는 추가 기능 권한이 필요합니다.
`403`	`ErrorResponse`	키 또는 호출자에게 필요한 스코프나 권한이 없습니다. `email_not_verified`인 경우 계정 이메일을 인증한 뒤 다시 시도하세요.
`404`	`ErrorResponse`	`workspace_id`로 선택한 워크스페이스가 존재하지 않거나 삭제되었거나 자격 증명의 워크스페이스 범위 밖에 있습니다.
`406`	`ErrorResponse`	`Accept` 헤더가 이 엔드포인트가 생성하는 모든 media type을 제외했습니다.
`429`	`ErrorResponse`	요청이 너무 많습니다. `Retry-After`가 있으면 해당 간격 뒤에 다시 시도하세요.
`503`	`ErrorResponse`	서비스를 일시적으로 사용할 수 없거나 처리 기한이 만료되었습니다(`request_timeout`). mutation은 완료될 수 있으므로 다시 시도하기 전에 리소스 상태를 확인하세요.
`default`	`ErrorResponse`	오류입니다. 응답 본문은 표준 오류 envelope을 사용합니다. `status`는 HTTP 상태 코드와 같고 `type`은 machine-readable 오류 코드입니다.

응답 헤더

상태	헤더	타입	설명
`200`	`Lovable-Beta`	`string`	요청에 적용된 beta revision입니다. 쉼표로 구분됩니다. 요청이 beta revision을 선택한 경우에만 있습니다.
`200`	`Lovable-Version`	`string`	요청을 처리한 안정 API 버전입니다. 버전 선택 전에 요청이 거부되었거나 버전 선택 자체가 실패한 경우에는 없습니다.
`200`	`X-Lovable-Unknown-Query-Params`	`string`	요청에 이 작업이 선언하지 않은 query parameter가 포함된 경우에만 있습니다. 무시된 매개변수 이름을 URL escape 후 쉼표로 구분해 최대 20개까지 제공합니다.
`200`	`X-Lovable-Unknown-Query-Params-Omitted`	`integer`	알 수 없는 매개변수가 20개를 넘어 무시되었을 때 `X-Lovable-Unknown-Query-Params`와 함께 제공됩니다. 해당 헤더에서 빠진 이름의 수입니다.
`200`	`X-RateLimit-Limit`	`integer`	소진에 가장 가까운 속도 제한에서 시간 창마다 허용되는 최대 요청 수입니다. 세 `X-RateLimit` 헤더는 모두 같은 제한을 설명합니다.
`200`	`X-RateLimit-Remaining`	`integer`	`X-RateLimit-Limit`가 설명하는 제한 안에서 아직 사용할 수 있는 요청 수입니다.
`200`	`X-RateLimit-Reset`	`integer`	`X-RateLimit-Limit`가 설명하는 제한이 다음에 용량을 회복하는 시각입니다. Unix timestamp 초 단위입니다. 알 수 없으면 생략됩니다.
`200`	`X-Request-Id`	`string`	이 요청의 식별자입니다. 오류 envelope의 `request_id`와 일치합니다. 실패를 보고할 때 이 값을 인용하세요.
`400`	`Lovable-Beta`	`string`	요청에 적용된 beta revision입니다. 쉼표로 구분됩니다. 요청이 beta revision을 선택한 경우에만 있습니다.
`400`	`Lovable-Version`	`string`	요청을 처리한 안정 API 버전입니다. 버전 선택 전에 요청이 거부되었거나 버전 선택 자체가 실패한 경우에는 없습니다.
`400`	`X-Lovable-Unknown-Query-Params`	`string`	요청에 이 작업이 선언하지 않은 query parameter가 포함된 경우에만 있습니다. 무시된 매개변수 이름을 URL escape 후 쉼표로 구분해 최대 20개까지 제공합니다.
`400`	`X-Lovable-Unknown-Query-Params-Omitted`	`integer`	알 수 없는 매개변수가 20개를 넘어 무시되었을 때 `X-Lovable-Unknown-Query-Params`와 함께 제공됩니다. 해당 헤더에서 빠진 이름의 수입니다.
`400`	`X-RateLimit-Limit`	`integer`	소진에 가장 가까운 속도 제한에서 시간 창마다 허용되는 최대 요청 수입니다. 세 `X-RateLimit` 헤더는 모두 같은 제한을 설명합니다.
`400`	`X-RateLimit-Remaining`	`integer`	`X-RateLimit-Limit`가 설명하는 제한 안에서 아직 사용할 수 있는 요청 수입니다.
`400`	`X-RateLimit-Reset`	`integer`	`X-RateLimit-Limit`가 설명하는 제한이 다음에 용량을 회복하는 시각입니다. Unix timestamp 초 단위입니다. 알 수 없으면 생략됩니다.
`400`	`X-Request-Id`	`string`	이 요청의 식별자입니다. 오류 envelope의 `request_id`와 일치합니다. 실패를 보고할 때 이 값을 인용하세요.
`401`	`WWW-Authenticate`	`string`	지원되는 인증 scheme을 식별하는 authentication challenge입니다.
`401`	`X-Lovable-Unknown-Query-Params`	`string`	요청에 이 작업이 선언하지 않은 query parameter가 포함된 경우에만 있습니다. 무시된 매개변수 이름을 URL escape 후 쉼표로 구분해 최대 20개까지 제공합니다.
`401`	`X-Lovable-Unknown-Query-Params-Omitted`	`integer`	알 수 없는 매개변수가 20개를 넘어 무시되었을 때 `X-Lovable-Unknown-Query-Params`와 함께 제공됩니다. 해당 헤더에서 빠진 이름의 수입니다.
`401`	`X-RateLimit-Limit`	`integer`	소진에 가장 가까운 속도 제한에서 시간 창마다 허용되는 최대 요청 수입니다. 세 `X-RateLimit` 헤더는 모두 같은 제한을 설명합니다.
`401`	`X-RateLimit-Remaining`	`integer`	`X-RateLimit-Limit`가 설명하는 제한 안에서 아직 사용할 수 있는 요청 수입니다.
`401`	`X-RateLimit-Reset`	`integer`	`X-RateLimit-Limit`가 설명하는 제한이 다음에 용량을 회복하는 시각입니다. Unix timestamp 초 단위입니다. 알 수 없으면 생략됩니다.
`401`	`X-Request-Id`	`string`	이 요청의 식별자입니다. 오류 envelope의 `request_id`와 일치합니다. 실패를 보고할 때 이 값을 인용하세요.
`402`	`X-Lovable-Unknown-Query-Params`	`string`	요청에 이 작업이 선언하지 않은 query parameter가 포함된 경우에만 있습니다. 무시된 매개변수 이름을 URL escape 후 쉼표로 구분해 최대 20개까지 제공합니다.
`402`	`X-Lovable-Unknown-Query-Params-Omitted`	`integer`	알 수 없는 매개변수가 20개를 넘어 무시되었을 때 `X-Lovable-Unknown-Query-Params`와 함께 제공됩니다. 해당 헤더에서 빠진 이름의 수입니다.
`402`	`X-RateLimit-Limit`	`integer`	소진에 가장 가까운 속도 제한에서 시간 창마다 허용되는 최대 요청 수입니다. 세 `X-RateLimit` 헤더는 모두 같은 제한을 설명합니다.
`402`	`X-RateLimit-Remaining`	`integer`	`X-RateLimit-Limit`가 설명하는 제한 안에서 아직 사용할 수 있는 요청 수입니다.
`402`	`X-RateLimit-Reset`	`integer`	`X-RateLimit-Limit`가 설명하는 제한이 다음에 용량을 회복하는 시각입니다. Unix timestamp 초 단위입니다. 알 수 없으면 생략됩니다.
`402`	`X-Request-Id`	`string`	이 요청의 식별자입니다. 오류 envelope의 `request_id`와 일치합니다. 실패를 보고할 때 이 값을 인용하세요.
`403`	`X-Lovable-Unknown-Query-Params`	`string`	요청에 이 작업이 선언하지 않은 query parameter가 포함된 경우에만 있습니다. 무시된 매개변수 이름을 URL escape 후 쉼표로 구분해 최대 20개까지 제공합니다.
`403`	`X-Lovable-Unknown-Query-Params-Omitted`	`integer`	알 수 없는 매개변수가 20개를 넘어 무시되었을 때 `X-Lovable-Unknown-Query-Params`와 함께 제공됩니다. 해당 헤더에서 빠진 이름의 수입니다.
`403`	`X-RateLimit-Limit`	`integer`	소진에 가장 가까운 속도 제한에서 시간 창마다 허용되는 최대 요청 수입니다. 세 `X-RateLimit` 헤더는 모두 같은 제한을 설명합니다.
`403`	`X-RateLimit-Remaining`	`integer`	`X-RateLimit-Limit`가 설명하는 제한 안에서 아직 사용할 수 있는 요청 수입니다.
`403`	`X-RateLimit-Reset`	`integer`	`X-RateLimit-Limit`가 설명하는 제한이 다음에 용량을 회복하는 시각입니다. Unix timestamp 초 단위입니다. 알 수 없으면 생략됩니다.
`403`	`X-Request-Id`	`string`	이 요청의 식별자입니다. 오류 envelope의 `request_id`와 일치합니다. 실패를 보고할 때 이 값을 인용하세요.
`404`	`Lovable-Beta`	`string`	요청에 적용된 beta revision입니다. 쉼표로 구분됩니다. 요청이 beta revision을 선택한 경우에만 있습니다.
`404`	`Lovable-Version`	`string`	요청을 처리한 안정 API 버전입니다. 버전 선택 전에 요청이 거부되었거나 버전 선택 자체가 실패한 경우에는 없습니다.
`404`	`X-Lovable-Unknown-Query-Params`	`string`	요청에 이 작업이 선언하지 않은 query parameter가 포함된 경우에만 있습니다. 무시된 매개변수 이름을 URL escape 후 쉼표로 구분해 최대 20개까지 제공합니다.
`404`	`X-Lovable-Unknown-Query-Params-Omitted`	`integer`	알 수 없는 매개변수가 20개를 넘어 무시되었을 때 `X-Lovable-Unknown-Query-Params`와 함께 제공됩니다. 해당 헤더에서 빠진 이름의 수입니다.
`404`	`X-RateLimit-Limit`	`integer`	소진에 가장 가까운 속도 제한에서 시간 창마다 허용되는 최대 요청 수입니다. 세 `X-RateLimit` 헤더는 모두 같은 제한을 설명합니다.
`404`	`X-RateLimit-Remaining`	`integer`	`X-RateLimit-Limit`가 설명하는 제한 안에서 아직 사용할 수 있는 요청 수입니다.
`404`	`X-RateLimit-Reset`	`integer`	`X-RateLimit-Limit`가 설명하는 제한이 다음에 용량을 회복하는 시각입니다. Unix timestamp 초 단위입니다. 알 수 없으면 생략됩니다.
`404`	`X-Request-Id`	`string`	이 요청의 식별자입니다. 오류 envelope의 `request_id`와 일치합니다. 실패를 보고할 때 이 값을 인용하세요.
`406`	`Lovable-Beta`	`string`	요청에 적용된 beta revision입니다. 쉼표로 구분됩니다. 요청이 beta revision을 선택한 경우에만 있습니다.
`406`	`Lovable-Version`	`string`	요청을 처리한 안정 API 버전입니다. 버전 선택 전에 요청이 거부되었거나 버전 선택 자체가 실패한 경우에는 없습니다.
`406`	`X-Lovable-Unknown-Query-Params`	`string`	요청에 이 작업이 선언하지 않은 query parameter가 포함된 경우에만 있습니다. 무시된 매개변수 이름을 URL escape 후 쉼표로 구분해 최대 20개까지 제공합니다.
`406`	`X-Lovable-Unknown-Query-Params-Omitted`	`integer`	알 수 없는 매개변수가 20개를 넘어 무시되었을 때 `X-Lovable-Unknown-Query-Params`와 함께 제공됩니다. 해당 헤더에서 빠진 이름의 수입니다.
`406`	`X-RateLimit-Limit`	`integer`	소진에 가장 가까운 속도 제한에서 시간 창마다 허용되는 최대 요청 수입니다. 세 `X-RateLimit` 헤더는 모두 같은 제한을 설명합니다.
`406`	`X-RateLimit-Remaining`	`integer`	`X-RateLimit-Limit`가 설명하는 제한 안에서 아직 사용할 수 있는 요청 수입니다.
`406`	`X-RateLimit-Reset`	`integer`	`X-RateLimit-Limit`가 설명하는 제한이 다음에 용량을 회복하는 시각입니다. Unix timestamp 초 단위입니다. 알 수 없으면 생략됩니다.
`406`	`X-Request-Id`	`string`	이 요청의 식별자입니다. 오류 envelope의 `request_id`와 일치합니다. 실패를 보고할 때 이 값을 인용하세요.
`429`	`Retry-After`	`integer`	다시 시도하기 전에 기다릴 초 단위 시간입니다. `minimum: 1`입니다. limiter가 재시도 지연 시간을 계산할 수 있을 때 제공됩니다.
`429`	`X-Lovable-Unknown-Query-Params`	`string`	요청에 이 작업이 선언하지 않은 query parameter가 포함된 경우에만 있습니다. 무시된 매개변수 이름을 URL escape 후 쉼표로 구분해 최대 20개까지 제공합니다.
`429`	`X-Lovable-Unknown-Query-Params-Omitted`	`integer`	알 수 없는 매개변수가 20개를 넘어 무시되었을 때 `X-Lovable-Unknown-Query-Params`와 함께 제공됩니다. 해당 헤더에서 빠진 이름의 수입니다.
`429`	`X-RateLimit-Limit`	`integer`	소진에 가장 가까운 속도 제한에서 시간 창마다 허용되는 최대 요청 수입니다. 세 `X-RateLimit` 헤더는 모두 같은 제한을 설명합니다.
`429`	`X-RateLimit-Remaining`	`integer`	`X-RateLimit-Limit`가 설명하는 제한 안에서 아직 사용할 수 있는 요청 수입니다.
`429`	`X-RateLimit-Reset`	`integer`	`X-RateLimit-Limit`가 설명하는 제한이 다음에 용량을 회복하는 시각입니다. Unix timestamp 초 단위입니다. 알 수 없으면 생략됩니다.
`429`	`X-Request-Id`	`string`	이 요청의 식별자입니다. 오류 envelope의 `request_id`와 일치합니다. 실패를 보고할 때 이 값을 인용하세요.
`503`	`Lovable-Beta`	`string`	요청에 적용된 beta revision입니다. 쉼표로 구분됩니다. 요청이 beta revision을 선택한 경우에만 있습니다.
`503`	`Lovable-Version`	`string`	요청을 처리한 안정 API 버전입니다. 버전 선택 전에 요청이 거부되었거나 버전 선택 자체가 실패한 경우에는 없습니다.
`503`	`X-Lovable-Unknown-Query-Params`	`string`	요청에 이 작업이 선언하지 않은 query parameter가 포함된 경우에만 있습니다. 무시된 매개변수 이름을 URL escape 후 쉼표로 구분해 최대 20개까지 제공합니다.
`503`	`X-Lovable-Unknown-Query-Params-Omitted`	`integer`	알 수 없는 매개변수가 20개를 넘어 무시되었을 때 `X-Lovable-Unknown-Query-Params`와 함께 제공됩니다. 해당 헤더에서 빠진 이름의 수입니다.
`503`	`X-RateLimit-Limit`	`integer`	소진에 가장 가까운 속도 제한에서 시간 창마다 허용되는 최대 요청 수입니다. 세 `X-RateLimit` 헤더는 모두 같은 제한을 설명합니다.
`503`	`X-RateLimit-Remaining`	`integer`	`X-RateLimit-Limit`가 설명하는 제한 안에서 아직 사용할 수 있는 요청 수입니다.
`503`	`X-RateLimit-Reset`	`integer`	`X-RateLimit-Limit`가 설명하는 제한이 다음에 용량을 회복하는 시각입니다. Unix timestamp 초 단위입니다. 알 수 없으면 생략됩니다.
`503`	`X-Request-Id`	`string`	이 요청의 식별자입니다. 오류 envelope의 `request_id`와 일치합니다. 실패를 보고할 때 이 값을 인용하세요.
`default`	`Lovable-Beta`	`string`	요청에 적용된 beta revision입니다. 쉼표로 구분됩니다. 요청이 beta revision을 선택한 경우에만 있습니다.
`default`	`Lovable-Version`	`string`	요청을 처리한 안정 API 버전입니다. 버전 선택 전에 요청이 거부되었거나 버전 선택 자체가 실패한 경우에는 없습니다.
`default`	`X-Lovable-Unknown-Query-Params`	`string`	요청에 이 작업이 선언하지 않은 query parameter가 포함된 경우에만 있습니다. 무시된 매개변수 이름을 URL escape 후 쉼표로 구분해 최대 20개까지 제공합니다.
`default`	`X-Lovable-Unknown-Query-Params-Omitted`	`integer`	알 수 없는 매개변수가 20개를 넘어 무시되었을 때 `X-Lovable-Unknown-Query-Params`와 함께 제공됩니다. 해당 헤더에서 빠진 이름의 수입니다.
`default`	`X-RateLimit-Limit`	`integer`	소진에 가장 가까운 속도 제한에서 시간 창마다 허용되는 최대 요청 수입니다. 세 `X-RateLimit` 헤더는 모두 같은 제한을 설명합니다.
`default`	`X-RateLimit-Remaining`	`integer`	`X-RateLimit-Limit`가 설명하는 제한 안에서 아직 사용할 수 있는 요청 수입니다.
`default`	`X-RateLimit-Reset`	`integer`	`X-RateLimit-Limit`가 설명하는 제한이 다음에 용량을 회복하는 시각입니다. Unix timestamp 초 단위입니다. 알 수 없으면 생략됩니다.
`default`	`X-Request-Id`	`string`	이 요청의 식별자입니다. 오류 envelope의 `request_id`와 일치합니다. 실패를 보고할 때 이 값을 인용하세요.

Schema

필드 이름과 enum 값은 OpenAPI contract의 식별자를 그대로 유지합니다. 설명은 한국어로 옮겼습니다. null이 타입에 포함된 필드는 값이 없을 수 있습니다.

`ProjectSummaryPage`

필드	필수	타입	제약	설명
`data`	예	`array of ProjectSummary`	-	이 페이지의 항목입니다. 항목이 없으면 빈 배열입니다.
`pagination`	예	`Pagination`	-	더 많은 결과가 있는지와 다음 페이지를 가져올 cursor입니다.

`ErrorResponse`

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

필드	필수	타입	제약	설명	예시
`detail`	예	`string \	null`	-	이번 오류에 대한 사람이 읽을 수 있는 안내입니다. 적용되지 않으면 `null`입니다. `invalid_request`에서는 `validation failed`이며 실행 가능한 필드 메시지는 `errors`에 있습니다. 다른 오류 유형은 재인증 안내 같은 정보를 제공할 수 있습니다.
`errors`	예	`array \	null`	-	검증 실패 시 필드 단위 오류 상세 정보입니다. 필드 단위 상세 정보가 적용되지 않으면 `null`입니다.
`props`	예	`object \	null`	-	오류별 metadata입니다. 적용되지 않으면 `null`입니다. key는 `type`에 따라 달라집니다. `security_critical_findings`에는 `finding_refs` 문자열 배열이 포함되고, `retired_version`과 `retired_beta`에는 `migration_url` 문자열 URL이 포함될 수 있습니다. 인식하지 못한 key는 무시하세요.
`request_id`	예	`string`	-	`X-Request-Id` 응답 헤더에서 반복되는 이 요청의 식별자입니다. 실패를 보고할 때 이 값을 인용하세요.	`4bf92f3577b34da6a3ce929d0e0e4736`
`status`	예	`integer`	-	본문에 반복되는 HTTP 상태 코드입니다.	`429`
`title`	예	`string`	-	사람이 읽을 수 있는 오류 요약입니다. 문구는 바뀔 수 있으므로 애플리케이션의 오류 처리는 `type`을 기준으로 결정하세요.	`Too Many Requests`
`type`	예	`string`	-	안정적인 machine-readable 오류 유형입니다. URI가 아니라 `rate_limited` 같은 `snake_case` token입니다. 클라이언트는 이 값으로 분기할 수 있으며 새 유형은 추가될 수 있습니다.	`rate_limited`

`ProjectSummary`

필드	필수	타입	제약	설명	예시
`created_at`	예	`string \	null`	format: `date-time`	프로젝트가 생성된 시각입니다. 사용할 수 없으면 `null`입니다.
`description`	예	`string \	null`	-	프로젝트가 수행하는 일을 AI가 작성한 요약입니다. agent가 프로젝트에 대한 응답을 완료하기 전까지는 `null`입니다.
`id`	예	`string`	-	프로젝트 ID입니다.	`prj_01jw3k9m2xq8r5v0c7d4e6f2gh`
`is_published`	예	`boolean`	-	프로젝트가 게시되었는지 여부입니다.	`true`
`last_edited_at`	예	`string \	null`	format: `date-time`	프로젝트가 마지막으로 편집 또는 사용자 chat message를 받은 시각입니다. 둘 다 발생하지 않았으면 `null`입니다.
`latest_screenshot_url`	예	`string \	null`	-	최신 screenshot URL입니다. 캡처되기 전까지는 `null`입니다.
`name`	예	`string \	null`	-	사람이 읽을 수 있는 프로젝트 이름입니다. 설정되지 않았으면 `null`입니다.
`owner_id`	예	`string \	null`	-	프로젝트 소유자 user UUID입니다. derived UUID를 사용하는 클라이언트에서는 OAuth subject와 일치합니다. 사용할 수 없으면 `null`입니다.
`publish_audience`	예	`string \	null`	enum: `public`, `workspace`, `custom`, `null`	게시된 앱을 열 수 있는 대상입니다. `POST` 또는 `PATCH /v1/projects/{project_id}/publish`로 설정한 audience입니다. 앱이 게시되지 않은 동안에는 `null`입니다. 값이 추가될 수 있으므로 클라이언트는 알 수 없는 값을 허용해야 합니다.
`visibility`	예	`string \	null`	enum: `restricted`, `workspace_edit`, `workspace_view`, `null`	Lovable 에디터에서 프로젝트를 열 수 있는 사람입니다. `restricted`는 프로젝트 소유자, 초대된 협업자, 워크스페이스 소유자(Business 또는 Enterprise)만 접근할 수 있다는 뜻입니다. `workspace_edit`는 모든 워크스페이스 멤버가 자신의 워크스페이스 role이 부여하는 접근 수준으로 접근할 수 있다는 뜻입니다. `workspace_view`는 모든 워크스페이스 멤버가 자신의 role이 부여하는 접근 권한을 읽기 수준으로 제한해 접근한다는 뜻입니다. 명시적인 프로젝트, 폴더, group grant는 여전히 편집을 허용합니다(Business 또는 Enterprise). 저장된 설정이 없으면 `null`입니다. 게시된 앱 접근 권한은 `publish_audience`로 별도 구성됩니다. 값이 추가될 수 있으므로 클라이언트는 알 수 없는 값을 허용해야 합니다.
`workspace_id`	예	`string`	-	프로젝트가 속한 워크스페이스입니다.	`workspace_01jw3k9m2xq8r5v0c7d4e6f2gh`

`Pagination`

필드	필수	타입	제약	설명	예시
`has_more`	예	`boolean`	-	이 페이지 뒤에 더 많은 결과가 있는지 여부입니다.	`true`
`next_cursor`	예	`string \	null`	-	다음 페이지를 가져오려면 이 값을 `cursor` query parameter로 전달합니다. opaque string으로 취급하세요. 더 이상 결과가 없으면 `null`입니다.

On this page