프로젝트 게시

플랜: Business 이상

스코프: projects:write

프로젝트를 빌드하고 배포합니다. 이 엔드포인트는 202와 Deployment 표현을 반환합니다. 처음 상태는 running이고 url 및 오류 필드는 null입니다. 배포가 끝날 때까지 GET /v1/projects/{project_id}/publish/{deployment_id}를 poll하세요.

필요하면 audience로 게시된 앱을 열 수 있는 대상을 선택할 수 있습니다. 프로젝트 읽기 응답에서는 이 값이 publish_audience로 보고됩니다. audience를 생략하면 현재 설정을 유지합니다. audience 변경은 새 배포가 끝나기 전에 현재 게시된 버전에 즉시 적용됩니다. 앱을 다시 빌드하지 않고 접근 설정만 바꾸려면 PATCH /v1/projects/{project_id}/publish를 사용합니다. 앱을 오프라인으로 전환하려면 DELETE /v1/projects/{project_id}/publish를 사용합니다.

OpenAPI

POST /v1/projects/{project_id}/publish

인증

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

매개변수

요청 본문

요청 본문은 필수입니다. Content-Type은 application/json입니다. 본문은 PublishProjectRequest 스키마를 사용합니다.

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

예시

curl --request POST \
  --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: "POST",
  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());

응답

응답 헤더

모든 응답에는 상황에 따라 다음 공통 헤더가 포함될 수 있습니다: 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 초 단위입니다.

POST /v1/projects/{project_id}/publish의 202 응답은 추가로 string인 Location 헤더를 제공하며, 이 값은 반환된 deployment 상태를 poll할 GET /v1/projects/{project_id}/publish/{deployment_id} URL입니다.

스키마

PublishAudienceTarget

Deployment 응답 스키마는 게시 상태 조회와 같습니다. id, status, url, error_message, error_class는 모두 필수 필드입니다. status는 running, completed, error, unknown 값을 사용할 수 있으며 클라이언트는 새 값을 허용해야 합니다. url, error_message, error_class는 값이 없으면 null입니다. error_class는 transient, code, configuration, data, integration, policy, internal, null 중 하나이며 새 값이 추가될 수 있습니다.

ErrorResponse

공통 오류 응답입니다.

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

관련 주제

• 게시 상태 조회
• 게시 설정 업데이트
• 프로젝트 게시 취소