Company member sites

Record that a site's branch was updated from live

After the branch’s folder merged the site’s live source and was published to the branch, records the site’s live bundle as the branch’s base, so the branch reads parent_changed: false. The base is recorded only when the source commit the branch’s published bundle records contains the one the live bundle records; otherwise it is refused with the same error a promote would answer. The body is empty. The answer is the branch, as reading it answers.

Needs application_themes.update and a signed-in admin who may edit the branch’s drafts. It answers 404 for every caller that passes those checks until staging is released to the company. A droplet installation token and an OAuth client token are refused with 403.

POST

api

company

v2026-10

member-sites

{id}

branches

{slug}

base

Record that a site's branch was updated from live

curl --request POST \
  --url https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches/{slug}/base \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

import requests

url = "https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches/{slug}/base"

payload = {}
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({})
};

fetch('https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches/{slug}/base', 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/{slug}/base",
  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([
    
  ]),
  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/{slug}/base"

	payload := strings.NewReader("{}")

	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/{slug}/base")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches/{slug}/base")

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 = "{}"

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": 200,
  "meta": {
    "request_uuid": "3b8f1d27-6c4e-4a91-8e5d-2f7c9a1b0e64",
    "timestamp": "2026-11-13T10:00:00Z"
  }
}

{}

{}

{
  "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"
  }
}

{
  "error": {
    "message": "<string>",
    "details": {}
  },
  "status": 123,
  "meta": {
    "request_uuid": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Authorizations

Authorization

string

header

required

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

string<uuid>

required

The site's id.

slug

string

required

The slug of one of the site's branches.

Required string length: 1 - 40

Pattern: ^[a-z0-9]+(-[a-z0-9]+)*$

Body

application/json

The body of a base record takes no field; the base is always the parent's live bundle.

Response

The branch, with its new base.

One branch.

branch

object

required

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

status

integer

required

The HTTP status.

meta

object

required

Response metadata included on every response body.

Show child attributes

Record that a site's branch was updated from live

curl --request POST \
  --url https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches/{slug}/base \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

import requests

url = "https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches/{slug}/base"

payload = {}
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({})
};

fetch('https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches/{slug}/base', 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/{slug}/base",
  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([
    
  ]),
  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/{slug}/base"

	payload := strings.NewReader("{}")

	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/{slug}/base")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches/{slug}/base")

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 = "{}"

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": 200,
  "meta": {
    "request_uuid": "3b8f1d27-6c4e-4a91-8e5d-2f7c9a1b0e64",
    "timestamp": "2026-11-13T10:00:00Z"
  }
}

{}

{}

{
  "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"
  }
}

{
  "error": {
    "message": "<string>",
    "details": {}
  },
  "status": 123,
  "meta": {
    "request_uuid": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Overview

Storefront

Commerce

Checkout

Member API

Member Sites APIs

Messaging

Cowork

People

Payments

DAM

Website

Portal

Mobile app

Content and tools

Analytics

Sales channels

Settings

FairShare SDK

Droplets

Developers

Unsorted endpoints

Portal & Widgets

Record that a site's branch was updated from live

Authorizations

Path Parameters

Body

Response