Publish Branch

POST

https://api.webflow.com/beta/sites/:site_id/branches/:branch_id/publish

POST

/beta/sites/:site_id/branches/:branch_id/publish

curl -X POST https://api.webflow.com/beta/sites/580e63e98c9a982ac9b8b741/branches/6a86085da0c9778de39f4965/publish \
     -H "Authorization: Bearer <token>"

{
  "taskId": "8296a4f1-77aa-4c3e-9a6c-ef5efcb19b50",
  "status": "queued",
  "stagingDomain": "branch-preview.webflow.io",
  "publishedOn": "2026-08-26T18:05:24.000Z",
  "nextActions": [
    {
      "action": "poll_task",
      "method": "GET",
      "href": "/beta/sites/580e63e98c9a982ac9b8b741/branches/tasks/8296a4f1-77aa-4c3e-9a6c-ef5efcb19b50"
    },
    {
      "action": "check_conflicts",
      "method": "GET",
      "href": "/beta/sites/580e63e98c9a982ac9b8b741/branches/6a86085da0c9778de39f4965/conflicts"
    },
    {
      "action": "merge",
      "method": "POST",
      "href": "/beta/sites/580e63e98c9a982ac9b8b741/branches/6a86085da0c9778de39f4965/merge"
    },
    {
      "action": "get_branch",
      "method": "GET",
      "href": "/beta/sites/580e63e98c9a982ac9b8b741/branches/6a86085da0c9778de39f4965"
    }
  ]
}

Enqueue an async task to publish the branch page preview to its configured staging domain.

This does not publish production domains or merge the branch into main. Poll the returned taskId until the publish task finishes.

Enterprise Only

This endpoint requires an Enterprise workspace with the page branching entitlement.

Required scope | branches:publish

Enqueue an async task to publish the branch page preview to its configured staging domain. This does **not** publish production domains or merge the branch into main. Poll the returned `taskId` until the publish task finishes. <Warning title="Enterprise Only">This endpoint requires an Enterprise workspace with the page branching entitlement.</Warning> Required scope | `branches:publish`

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

site_idstringRequiredformat: "objectid"

Unique identifier for a Site

branch_idstringRequiredformat: "objectid"

Unique identifier for a Branch

Response

Branch publish task accepted

taskIdstringformat: "uuid"

statusstring

stagingDomainstring

Staging domain the branch preview will publish to.

publishedOnstringformat: "date-time"

Timestamp when the publish was triggered (not when the queued job finished).

nextActionslist of objects

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

429

Too Many Requests Error

500

Internal Server Error