---
title: "Publish a workspace"
method: POST
path: "/workspaces/{workspaceId}/publish"
tags: ["workspaces"]
---

# Publish a workspace

`POST /workspaces/{workspaceId}/publish`

## Path parameters

- `workspaceId` string, required

## Response `200`

Returns the deployment object.

- DeploymentOutput
  - `data` object, required
    - `_id` string, required — The ID of the app.
    - `status` 'SUCCESS' | 'FAILURE', required — Status of the deployment, whether it succeeded or failed
    - `appUrl` string, required — The URL of the published app

## Changes

- **2025-08-12** `e78c520d5c4c` — 1 info
  - endpoint added
- **2023-03-06** `7de0ab0187e0` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/budibase/apis/budibase-api/changes/workspaces/:workspaceId/publish/post.md)

---

[API](https://skmtc.dev/budibase/apis/budibase-api.md) · [All operations](https://skmtc.dev/budibase/apis/budibase-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/budibase/budibase-api/revisions/9c6f16fc652b/schema)