Company member sites
Commit source to a site's branch
Commits the folder’s whole source tree onto the Git ref the branch owns on its parent’s repository, built on base_commit, and answers the new commit; start the branch’s bundle from it. The ref is always the branch’s own; the request never names one, so nothing but the branch’s ref is written. A commit from a head that is not the ref’s head is refused, so a commit never replaces commits it was not made from: pull the branch and publish again.
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}
/
source-commits
Commit source to a site's branch
curl --request POST \
--url https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches/{slug}/source-commits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"base_commit": "4f1c2a9e8b7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b",
"message": "Edit the home page",
"files": {
"index.html": "PGgxPkhpPC9oMT4="
}
}
'import requests
url = "https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches/{slug}/source-commits"
payload = {
"base_commit": "4f1c2a9e8b7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b",
"message": "Edit the home page",
"files": { "index.html": "PGgxPkhpPC9oMT4=" }
}
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({
base_commit: '4f1c2a9e8b7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b',
message: 'Edit the home page',
files: {'index.html': 'PGgxPkhpPC9oMT4='}
})
};
fetch('https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches/{slug}/source-commits', 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}/source-commits",
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([
'base_commit' => '4f1c2a9e8b7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b',
'message' => 'Edit the home page',
'files' => [
'index.html' => 'PGgxPkhpPC9oMT4='
]
]),
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}/source-commits"
payload := strings.NewReader("{\n \"base_commit\": \"4f1c2a9e8b7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b\",\n \"message\": \"Edit the home page\",\n \"files\": {\n \"index.html\": \"PGgxPkhpPC9oMT4=\"\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/{slug}/source-commits")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"base_commit\": \"4f1c2a9e8b7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b\",\n \"message\": \"Edit the home page\",\n \"files\": {\n \"index.html\": \"PGgxPkhpPC9oMT4=\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches/{slug}/source-commits")
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 \"base_commit\": \"4f1c2a9e8b7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b\",\n \"message\": \"Edit the home page\",\n \"files\": {\n \"index.html\": \"PGgxPkhpPC9oMT4=\"\n }\n}"
response = http.request(request)
puts response.read_body{
"source_commit": {
"commit": "9a8b7c6d5e4f3a2b1c0d9e8f7a6b5c4d3e2f1a0b"
},
"status": 201,
"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
Path Parameters
Body
application/json
The folder's whole source tree, committed onto the branch's own ref from the head it was made from.
Each file of the folder, its path relative to the folder's root (no leading slash, no . or .. segment, nothing under .git) to its content in Base64. A path the base commit holds that is not here is deleted, except dotfiles. The files hold at most 25 MiB decoded.
Show child attributes
Show child attributes
⌘I
Commit source to a site's branch
curl --request POST \
--url https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches/{slug}/source-commits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"base_commit": "4f1c2a9e8b7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b",
"message": "Edit the home page",
"files": {
"index.html": "PGgxPkhpPC9oMT4="
}
}
'import requests
url = "https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches/{slug}/source-commits"
payload = {
"base_commit": "4f1c2a9e8b7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b",
"message": "Edit the home page",
"files": { "index.html": "PGgxPkhpPC9oMT4=" }
}
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({
base_commit: '4f1c2a9e8b7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b',
message: 'Edit the home page',
files: {'index.html': 'PGgxPkhpPC9oMT4='}
})
};
fetch('https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches/{slug}/source-commits', 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}/source-commits",
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([
'base_commit' => '4f1c2a9e8b7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b',
'message' => 'Edit the home page',
'files' => [
'index.html' => 'PGgxPkhpPC9oMT4='
]
]),
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}/source-commits"
payload := strings.NewReader("{\n \"base_commit\": \"4f1c2a9e8b7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b\",\n \"message\": \"Edit the home page\",\n \"files\": {\n \"index.html\": \"PGgxPkhpPC9oMT4=\"\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/{slug}/source-commits")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"base_commit\": \"4f1c2a9e8b7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b\",\n \"message\": \"Edit the home page\",\n \"files\": {\n \"index.html\": \"PGgxPkhpPC9oMT4=\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/company/v2026-10/member-sites/{id}/branches/{slug}/source-commits")
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 \"base_commit\": \"4f1c2a9e8b7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b\",\n \"message\": \"Edit the home page\",\n \"files\": {\n \"index.html\": \"PGgxPkhpPC9oMT4=\"\n }\n}"
response = http.request(request)
puts response.read_body{
"source_commit": {
"commit": "9a8b7c6d5e4f3a2b1c0d9e8f7a6b5c4d3e2f1a0b"
},
"status": 201,
"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"
}
}