프로젝트 업데이트

Plan: Business or higher

Scope: projects:write

프로젝트 공유 설정이나 사람이 읽을 수 있는 이름을 업데이트합니다. description은 agent가 생성하므로 이 엔드포인트로 편집할 수 없습니다. 생략한 필드는 현재 값을 유지합니다. 게시된 앱에 대한 접근 권한은 바꾸지 않습니다. 그 설정은 PATCH /v1/projects/{project_id}/publish를 사용하세요.

OpenAPI

항목	값
Method	`PATCH`
Path	`/v1/projects/{project_id}`
Operation ID	`updateProject`
Source spec	`https://api.lovable.dev/v1/openapi.yaml`
Local snapshot	YAML 스냅샷 (SHA-256: `159b995d13cfb6e434b7571008c43d8f51ffe232fd231ff6c03ea5fb0c860892`)

PATCH /v1/projects/{project_id}

인증 및 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를 포함합니다. 프로젝트 계열과 워크스페이스 계열 사이에는 권한이 넘어가지 않습니다.

매개변수

이름	위치	필수	타입	제약	설명
`project_id`	`path`	예	`string`	-	프로젝트 ID입니다.
`Lovable-Version`	`header`	아니요	`string`	-	제공받을 안정 API 버전입니다. `YYYY-MM-DD` 날짜 형식으로 보냅니다. 생략하면 현재 가장 오래된 지원 안정 버전인 `2026-09-11`이 사용됩니다.
`Lovable-Beta`	`header`	아니요	`string`	-	안정 버전 위에 활성화할 베타 리비전 문자열입니다. 여러 개는 쉼표로 구분합니다.

요청 본문

필수 여부: 필수
Content-Type: application/json
Schema: UpdateProjectRequest

응답

상태	본문 schema	설명
`200`	`Project`	요청이 성공했습니다.
`400`	`ErrorResponse`	요청 본문이나 매개변수 형식이 잘못되었거나 검증에 실패했습니다. 실패한 각 필드는 `errors`에 나열됩니다.
`401`	`ErrorResponse`	API 키, session token, OAuth access token이 없거나 유효하지 않습니다.
`402`	`ErrorResponse`	Public API 접근에는 Business 이상 플랜이 필요합니다. 일부 작업이나 구성에는 추가 기능 권한이 필요합니다.
`403`	`ErrorResponse`	키 또는 호출자에게 필요한 스코프나 권한이 없습니다. `email_not_verified`인 경우 계정 이메일을 인증한 뒤 다시 시도하세요.
`404`	`ErrorResponse`	프로젝트가 존재하지 않거나 삭제되었거나 인증된 클라이언트가 접근할 수 없습니다.
`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이 타입에 포함된 필드는 값이 없을 수 있습니다.

`UpdateProjectRequest`

필드	필수	타입	제약	설명	예시
`name`	아니요	`string`	maxLength: `100`	프로젝트 표시 이름입니다. 1~100개 Unicode code point여야 하며 공백이 아닌 문자를 포함해야 합니다. Unicode letter, combining mark, number, space separator(`Zs`), 문장부호 `- _ . ' · & ( ) [ ] \| , ! : ‘ ’`, zero-width non-joiner/joiner `U+200C`/`U+200D`를 허용합니다. 그 밖의 문자(`🚀`, tab, 줄바꿈 포함), link, 인식된 domain name, IP 주소는 거부됩니다. 앞뒤 공백은 보존됩니다. 현재 이름을 유지하려면 생략하세요.	`Acme Landing Page`
`visibility`	아니요	`string`	enum: `restricted`, `workspace_edit`, `workspace_view`	Lovable 에디터에서 프로젝트를 열 수 있는 사람입니다. `restricted`는 프로젝트 소유자, 초대된 협업자, 워크스페이스 소유자(Business 또는 Enterprise)만 접근할 수 있다는 뜻입니다. `workspace_edit`는 모든 워크스페이스 멤버가 자신의 워크스페이스 role이 부여하는 접근 수준으로 접근할 수 있다는 뜻입니다. `workspace_view`는 모든 워크스페이스 멤버가 자신의 role이 부여하는 접근 권한을 읽기 수준으로 제한해 접근한다는 뜻입니다. 명시적인 프로젝트, 폴더, group grant는 여전히 편집을 허용합니다(Business 또는 Enterprise). 게시된 앱 접근 권한은 `publish_audience`로 별도 구성됩니다. 현재 설정을 유지하려면 생략하세요.	`workspace_edit`

`Project`

필드	필수	타입	제약	설명	예시
`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_commit_sha`	예	`string \	null`	-	최신 commit의 SHA입니다. 첫 commit 전에는 `null`입니다.
`latest_screenshot_url`	예	`string \	null`	-	최신 screenshot URL입니다. 캡처되기 전까지는 `null`입니다.
`name`	예	`string \	null`	-	사람이 읽을 수 있는 프로젝트 이름입니다. 설정되지 않았으면 `null`입니다.
`owner_id`	예	`string \	null`	-	프로젝트 소유자 user UUID입니다. derived UUID를 사용하는 클라이언트에서는 OAuth subject와 일치합니다. 사용할 수 없으면 `null`입니다.
`preview_url`	예	`string \	null`	-	프로젝트 main preview의 URL입니다. commit이 달라도 같은 주소에서 최신 성공 preview build를 제공합니다. 특정 commit이나 draft에 고정되지 않습니다. 프로젝트가 opt out하지 않는 한 워크스페이스의 branded hostname을 사용하며 branding이 바뀌면 변경될 수 있습니다. 환경에 preview host가 없으면 `null`입니다. URL이 있다는 사실이 preview build가 준비되었다는 뜻은 아닙니다. 인증 token은 포함하지 않습니다. 프로젝트가 public remixable이 아닌 한 열려면 Lovable 로그인이 필요합니다. third-party origin에서 embed하려면 `POST /v1/projects/{project_id}/embed-url`을 사용하세요.
`publish_audience`	예	`string \	null`	enum: `public`, `workspace`, `custom`, `null`	게시된 앱을 열 수 있는 대상입니다. `POST` 또는 `PATCH /v1/projects/{project_id}/publish`로 설정한 audience입니다. 앱이 게시되지 않은 동안에는 `null`입니다. 값이 추가될 수 있으므로 클라이언트는 알 수 없는 값을 허용해야 합니다.
`publish_audience_targets`	예	`array of PublishAudienceGrant`	-	`publish_audience`가 `custom`일 때 게시된 앱을 열 수 있는 group과 user입니다. 다른 audience이거나 앱이 오프라인이면 비어 있습니다. 초대나 조직 멤버십으로 권한을 받은 사용자는 포함되지만 조직 전체 접근 권한과 대기 중인 이메일 초대는 나열되지 않습니다.	-
`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`

`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`

`PublishAudienceGrant`

필드	필수	타입	제약	설명	예시
`id`	예	`string`	-	`GET /v1/workspaces/{workspace_id}/groups`가 반환한 group ID이거나 다른 응답이 보고하는 사용자 UUID입니다.	`grp_01jw3k9m2xq8r5v0c7d4e6f2gh`
`type`	예	`string`	enum: `group`, `user`	대상 유형입니다. user는 응답에 보고되지만 아직 `audience_targets`로 설정할 수 없습니다.	-

On this page