Branch a site
For an older Liquid site, makes a branch of a published site: a second site, owned as its parent is, cloned from the parent’s published layouts, sections, snippets, pages, settings, text assets and menus, and published at once, so its frame_path renders what the parent renders. Nothing the parent holds in draft is copied, and the parent is never changed. The branch is private and cannot be shared or made public, and it is left out of the site list. It has no Git repository.
A member’s site is branched by a company admin who holds a kept admin row as its owner would: the branch is the owner’s, counts against the owner’s site limit, and records the admin as its creator. It is refused with 404 to a root admin who holds none, when its owner was discarded and while the site is locked. A draft site, a taken-down site and a branch cannot be branched, and a site holding a binary asset cannot be branched. A site has one branch at a time. Needs application_themes.update and a signed-in admin. The body is optional.
For a gateway-served V1 parent, the branch starts as a private draft with an independent prepared bundle. Its files and database rows are copied in the background. The normal bundle publisher makes it current only after both copies are ready. Until then the branch’s status is draft. If the parent’s schema advances incompatibly during copying, the captured bundle is refused and remains unserved; inspect its failed bundle before rebuilding. V1 branches are edited and published through app bundles rather than older Liquid files.
curl --request POST \
--url https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"branch": {
"slug": "staging"
}
}
'import requests
url = "https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches"
payload = { "branch": { "slug": "staging" } }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({branch: {slug: 'staging'}})
};
fetch('https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'branch' => [
'slug' => 'staging'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches"
payload := strings.NewReader("{\n \"branch\": {\n \"slug\": \"staging\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"branch\": {\n \"slug\": \"staging\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"branch\": {\n \"slug\": \"staging\"\n }\n}"
response = http.request(request)
puts response.read_body{
"branch": {
"slug": "staging",
"site_id": "019a4e5f-7081-7c92-8da3-b4c5d6e7f80a",
"parent_id": "019a2b3c-4d5e-7f6a-8b7c-9d0e1f2a3b4c",
"handle": "primex-launch-staging",
"status": "published",
"frame_path": "/accounts/_frame/019a4e5f-7081-7c92-8da3-b4c5d6e7f80a",
"shell_path": "/sites/primex-launch-staging",
"url": "https://shop.example.com/sites/primex-launch-staging",
"parent_changed": false,
"created_at": "2026-10-16T10:00:00Z"
},
"status": 201,
"meta": {
"request_uuid": "3b8f1d27-6c4e-4a91-8e5d-2f7c9a1b0e64",
"timestamp": "2026-10-23T14:05:12Z"
}
}{}{}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_uuid": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_uuid": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_uuid": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}Authorizations
A company admin credential for your company, or a droplet installation token with the website scope for reads, except on the share routes, which refuse a droplet token.
Path Parameters
The site's id.
Body
Optional choices for a branch. The whole body may be omitted.
The choices for the branch.
Show child attributes
Show child attributes
Response
The new private branch. A Liquid branch is published immediately; a V1 branch remains draft until its files and database are ready. A failed database provisioning attempt keeps the accepted draft for automatic retry.
One branch.
The branch of a site: a second site, cloned from the published content of its parent and published at once, so it renders what the parent renders. It is private, owned as the parent is, and has no shares. Only its owner and company admins can open it, in the frame at frame_path. It is edited and published through the files, pages and publish operations with site_id as the site id, which serve a member's branch to a company admin who holds a kept admin row as they serve its parent; the parent never changes.
Show child attributes
Show child attributes
The HTTP status.
Response metadata included on every response body.
Show child attributes
Show child attributes
curl --request POST \
--url https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"branch": {
"slug": "staging"
}
}
'import requests
url = "https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches"
payload = { "branch": { "slug": "staging" } }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({branch: {slug: 'staging'}})
};
fetch('https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'branch' => [
'slug' => 'staging'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches"
payload := strings.NewReader("{\n \"branch\": {\n \"slug\": \"staging\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"branch\": {\n \"slug\": \"staging\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"branch\": {\n \"slug\": \"staging\"\n }\n}"
response = http.request(request)
puts response.read_body{
"branch": {
"slug": "staging",
"site_id": "019a4e5f-7081-7c92-8da3-b4c5d6e7f80a",
"parent_id": "019a2b3c-4d5e-7f6a-8b7c-9d0e1f2a3b4c",
"handle": "primex-launch-staging",
"status": "published",
"frame_path": "/accounts/_frame/019a4e5f-7081-7c92-8da3-b4c5d6e7f80a",
"shell_path": "/sites/primex-launch-staging",
"url": "https://shop.example.com/sites/primex-launch-staging",
"parent_changed": false,
"created_at": "2026-10-16T10:00:00Z"
},
"status": 201,
"meta": {
"request_uuid": "3b8f1d27-6c4e-4a91-8e5d-2f7c9a1b0e64",
"timestamp": "2026-10-23T14:05:12Z"
}
}{}{}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_uuid": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_uuid": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_uuid": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}