---
title: "Get publish status"
method: GET
path: "/v1/projects/{project_id}/publish/{deployment_id}"
tags: ["deploy-domains"]
---

# Get publish status

`GET /v1/projects/{project_id}/publish/{deployment_id}`

**Plan:** `All plans`

Returns the status of an async publish started with POST /v1/projects/{project_id}/publish, keyed by the deployment_id it returned. Poll until status is completed (url is set) or error (error_message explains the failure). Poll no more than once every 2 seconds and honor Retry-After on 429 responses.

## Path parameters

- `project_id` string, required — Project ID
- `deployment_id` string, required — Deployment ID returned by POST /v1/projects/{project_id}/publish

## Response `200`

OK

- PublicV1PublishStatusResponse
  - `deployment_id` string, required — The deployment being tracked
  - `error_class` string — Failure class when status is error: transient (a retry may succeed) or a user_* class (fix the project before republishing). Clients must tolerate new values.
  - `error_code` string — Machine-readable failure cause when one is recognized. Present only when status is error.
  - `error_message` string — Human-readable failure reason. Present only when status is error.
  - `status` 'running' | 'completed' | 'error' | 'unknown', required — Deployment status: running (still building or deploying), completed (published — url is set), error (failed — error_message explains why), or unknown. Clients must tolerate new values.
  - `url` string — Published project URL. Set once status is completed.

## Other responses

- `401` — Missing or invalid API key.
- `403` — The key or caller lacks the required scope or permission.
- `406` — The Accept header excludes every media type this endpoint produces.
- `429` — Too many requests. Retry after the interval in Retry-After when present.
- `default` — Error. The response body uses the standard error envelope; status matches the HTTP status code and type is a machine-readable error code.

---

[API](https://skmtc.net/lovable/apis/lovable-api.md) · [All operations](https://skmtc.net/lovable/apis/lovable-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lovable/lovable-api/revisions/aa8d44585147/schema)