Lovable한국어 문서
Deploy & Domains

앱을 다시 빌드하지 않고 게시된 앱의 접근 설정을 변경합니다.

게시 설정 업데이트

플랜: Business 이상

스코프: projects:write

앱을 다시 빌드하지 않고 게시된 앱의 접근 설정을 변경합니다. audience를 public, workspace, custom 중 하나로 설정합니다. 프로젝트 읽기 응답에서는 이 값이 publish_audience로 보고됩니다. custom audience에서 audience_targets를 보내면 그룹 및 사용자 grant를 대체하고 워크스페이스 전체 접근을 제거합니다. UI에서 관리하는 조직 접근과 이메일 초대는 보존됩니다. 변경 사항은 즉시 적용됩니다.

강제된 워크스페이스 게시 정책이 게시를 결정하는 환경에서는 public이 아닌 게시된 앱을 public으로 바꾸려면 반드시 게시를 거쳐야 하며, 그 게시는 최근 저장된 버전까지 함께 반영합니다. 이때는 POST /v1/projects/{project_id}/publish에서 audience를 public으로 설정하세요. PATCH로 공개 범위만 public으로 바꾸려는 요청에는 이 경로가 409 publish_visibility_requires_publish로 응답하기 때문입니다.

응답은 결정된 audience와 target을 반환합니다. is_published, publish_audience, publish_audience_targets는 GET /v1/projects/{project_id}에서 읽습니다. 새 버전을 빌드하고 게시하려면 POST /v1/projects/{project_id}/publish를 사용합니다. 앱을 오프라인으로 전환하려면 DELETE /v1/projects/{project_id}/publish를 사용합니다.

OpenAPI

항목값
MethodPATCH
Path/v1/projects/{project_id}/publish
Operation IDupdatePublishSettings
Source spechttps://api.lovable.dev/v1/openapi.yaml
Local snapshotYAML 스냅샷 (SHA-256: e85b15e7e0bda5bdd95e472fd72f4072d1d2e42ae9f8a51466d7ea9aab7c6199)
PATCH /v1/projects/{project_id}/publish

인증

Lovable-API-Key: lov_your-api-key 또는 Authorization: Bearer <key>를 보냅니다. 이 엔드포인트는 projects:write 스코프가 필요합니다.

매개변수

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

요청 본문

요청 본문은 필수입니다. Content-Type은 application/json입니다. 본문은 UpdatePublishSettingsRequest 스키마를 사용합니다. audience, audience_targets 중 하나 또는 둘 다를 보내며 빈 객체를 보내면 설정을 그대로 둡니다.

필드타입필수설명예시
audiencestring아니요게시된 앱을 열 수 있는 대상입니다. public, workspace, custom 중 하나입니다. 프로젝트 읽기 응답에서는 publish_audience로 보고됩니다. UI에서 관리하는 기존 grant를 포함한 custom audience를 사용할 수 있습니다. 생략하면 앱이 게시되지 않은 상태를 포함해 audience를 변경하지 않습니다.custom
audience_targetsPublishAudienceTarget[]아니요앱을 열 수 있는 그룹입니다. 전달한 audience 또는 현재 audience가 custom일 때만 허용됩니다. 목록을 제공하면 모든 그룹 및 사용자 grant를 대체하고 워크스페이스 전체 접근을 제거합니다. 빈 목록은 해당 grant를 제거합니다. UI에서 관리하는 기존 조직 접근과 이메일 초대는 보존됩니다. 생략하면 audience 변경 중에도 저장된 target을 유지합니다. custom 모드 밖에서는 target이 비활성입니다. null은 허용되지 않습니다. 최대 100개까지 보낼 수 있습니다.[{"id":"grp_01jw3k9m2xq8r5v0c7d4e6f2gh","type":"group"}]

UpdatePublishSettingsRequest는 위 표의 audience, audience_targets만 받습니다. 스키마에 선언되지 않은 필드를 함께 보내면 요청이 거부됩니다(additionalProperties: false).

PublishAudienceTarget은 type과 id를 필수로 가집니다. 현재 type은 group만 지원하며 id는 GET /v1/workspaces/{workspace_id}/groups가 반환한 그룹 ID입니다. id는 빈 문자열일 수 없으며(minLength: 1), audience_targets는 최대 100개까지 보낼 수 있습니다.

예시

curl --request PATCH \
  --url 'https://api.lovable.dev/v1/projects/project-id/publish' \
  --header 'Lovable-API-Key: lov_your-api-key' \
  --header 'Lovable-Version: 2026-09-11' \
  --header 'Content-Type: application/json' \
  --data '{}'
const response = await fetch("https://api.lovable.dev/v1/projects/project-id/publish", {
  method: "PATCH",
  headers: {
    "Lovable-API-Key": process.env.LOVABLE_API_KEY ?? "lov_your-api-key",
    "Lovable-Version": "2026-09-11",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({}),
});
if (!response.ok) {
  throw new Error(`Lovable API ${response.status}: ${await response.text()}`);
}
console.log(await response.json());

응답

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

오류 요구사항 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는 허용되는 스코프 목록이며 그중 '아무거나' 하나로 충족됩니다. 게시 설정 변경에는 projects:write가 그 목록에 해당합니다.

typeprops 구조와 의미
payment_required플랜 게이트는 최소 tier(pro, business, enterprise)를 담은 required_plan을 포함합니다. 기능 게이트는 대신 기능 권한 식별자 배열인 required_features를 포함하며 배열의 모든 항목이 필요합니다. 예를 들어 {"required_plan":"business"}입니다. 다른 결제 실패는 둘 다 없을 수 있습니다.
forbidden권한 게이트는 대체 가능한 권한 집합의 배열인 required_permissions를 포함합니다. 한 집합의 권한을 모두 가지면 그 게이트를 충족합니다. 예를 들어 [["project:edit"]]는 해당 권한을 요구하고 [["a","b"],["c"]]는 a와 b를 모두 가지거나 c를 가질 것을 요구합니다. 다른 거부에는 요구사항 metadata가 없을 수 있습니다.
insufficient_scoperequired_scopes는 허용되는 자격 증명 스코프의 배열이며 그중 하나만 있으면 실패한 스코프 검사를 충족합니다. 쓰기 스코프는 대응하는 읽기 스코프도 포함합니다. 예를 들어 {"required_scopes":["projects:write"]}입니다.
security_critical_findingsfinding_refs는 게시를 막는 보안 발견 항목을 식별하는 문자열 배열입니다. 예를 들어 {"finding_refs":["supabase/finding-1"]}입니다.
retired_version, retired_betamigration_url은 마이그레이션 가이드로 연결되는 문자열 URL이며 제공 가능한 경우에만 포함됩니다.

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

응답 헤더

모든 응답에는 상황에 따라 다음 공통 헤더가 포함될 수 있습니다: Lovable-Version, Lovable-Beta, X-Request-Id, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-Lovable-Unknown-Query-Params, X-Lovable-Unknown-Query-Params-Omitted. X-Lovable-Unknown-Query-Params는 이 작업이 선언하지 않은 query parameter가 있을 때 URL escape된 이름을 최대 20개까지 쉼표로 제공하며, 20개를 넘으면 X-Lovable-Unknown-Query-Params-Omitted가 누락된 개수(minimum: 1)를 제공합니다. 401 응답은 string인 WWW-Authenticate를, 429 응답은 integer인 Retry-After를 포함합니다. Retry-After는 minimum: 1입니다. X-RateLimit-Reset은 지연 시간이 아니라 Unix timestamp 초 단위입니다.

스키마

PublishAudienceTarget

필드타입필수제약설명예시
typestring예enum: group대상 유형입니다. 현재 그룹만 설정할 수 있습니다.group
idstring예minLength: 1GET /v1/workspaces/{workspace_id}/groups가 반환한 그룹 ID입니다.grp_01jw3k9m2xq8r5v0c7d4e6f2gh

PublishAudienceTarget은 type과 id 외의 필드를 받지 않습니다. 스키마에 선언되지 않은 필드가 포함된 target이 있으면 요청이 거부됩니다(additionalProperties: false).

PublishSettings

필드타입필수설명예시
audiencestring예게시된 앱을 열 수 있는 대상입니다. public, workspace, custom 중 하나입니다. 프로젝트 읽기 응답에서는 publish_audience로 보고됩니다. 새 값이 추가될 수 있으므로 클라이언트는 알 수 없는 값을 허용해야 합니다.custom
audience_targetsPublishAudienceGrant[]예앱이 오프라인이거나 audience가 custom이 아니어도 저장되어 있는 그룹 및 사용자입니다. 이 target은 custom 모드에서만 접근 권한을 부여합니다. 초대 또는 조직 멤버십으로 grant된 사용자는 포함되지만 조직 전체 접근과 대기 중인 이메일 초대는 나열되지 않습니다. 이 읽기 projection은 쓰기 가능한 target 목록이 아닙니다. audience_targets에는 그룹만 제공할 수 있습니다.[{"id":"grp_01jw3k9m2xq8r5v0c7d4e6f2gh","type":"group"}]

PublishAudienceGrant

필드타입필수설명예시
typestring예target 타입입니다. group 또는 user입니다. 사용자는 보고되지만 아직 audience_targets로 설정할 수 없습니다.group
idstring예GET /v1/workspaces/{workspace_id}/groups가 반환한 그룹 ID 또는 다른 응답이 보고하는 사용자 UUID입니다.grp_01jw3k9m2xq8r5v0c7d4e6f2gh

ErrorResponse

공통 오류 응답입니다. 작업에 따라 특정 상태 코드에 다른 응답 본문이 문서화될 수 있습니다.

필드타입필수설명예시
detail`string \null`예이번 오류에 대한 사람이 읽을 수 있는 안내입니다. 적용되지 않으면 null입니다. invalid_request에서는 validation failed이며 실행 가능한 필드 메시지는 errors에 있습니다.
errors`array \null`예검증 실패 시 필드 단위 오류 상세 정보입니다. 필드 단위 상세 정보가 적용되지 않으면 null입니다. 각 항목은 location과 message를 담으며 실패를 특정 필드에 귀속할 수 없으면 location이 null입니다.
props`object \null`예오류별 metadata입니다. 적용되지 않으면 null입니다. key는 type에 따라 달라지며 인식하지 못한 key는 무시하세요.
request_idstring예X-Request-Id 응답 헤더에서 반복되는 이 요청의 식별자입니다.4bf92f3577b34da6a3ce929d0e0e4736
statusinteger예본문에 반복되는 HTTP 상태 코드입니다.429
titlestring예사람이 읽을 수 있는 오류 요약입니다. 문구는 바뀔 수 있으므로 오류 처리는 type을 기준으로 결정하세요.Too Many Requests
typestring예안정적인 machine-readable 오류 유형입니다. URI가 아니라 rate_limited 같은 snake_case token입니다.rate_limited

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

On this page