Company site files and pages
Write a site file
Creates the file, or replaces its content, on a company site. Send the version of the file you read to refuse the write with 409 if the file changed or was removed since, or must_not_exist to create a file only if the path is free; without either the write replaces whatever is there, so the last write wins. The check and the write are one step, so a write that loses a race changes nothing. A page’s file must already exist; add the page first. Writing config/menus.json replaces all of the site’s menus, writing config/pages.json adds, changes and removes pages to match it and sets the site’s default layout (a page added this way starts with an empty file), and writing config/settings.json replaces its settings. config/access.json is refused with 422 on a company site, which takes no access declaration. Layouts, sections, snippets and pages are saved as drafts until the site is published. Assets must be css, js, json, txt or html text files. A member’s site is refused with 403. Needs application_themes.update and a signed-in admin.
PUT
/
api
/
company
/
v2026-10
/
member-sites
/
{id}
/
files
/
{path}
Write a site file
curl --request PUT \
--url https://api.fluid.app/api/company/v2026-10/member-sites/{id}/files/{path} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"member_site_file": {
"content": "{{ content_for_layout }}"
}
}
'import requests
url = "https://api.fluid.app/api/company/v2026-10/member-sites/{id}/files/{path}"
payload = { "member_site_file": { "content": "{{ content_for_layout }}" } }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({member_site_file: {content: '{{ content_for_layout }}'}})
};
fetch('https://api.fluid.app/api/company/v2026-10/member-sites/{id}/files/{path}', 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}/files/{path}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'member_site_file' => [
'content' => '{{ content_for_layout }}'
]
]),
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}/files/{path}"
payload := strings.NewReader("{\n \"member_site_file\": {\n \"content\": \"{{ content_for_layout }}\"\n }\n}")
req, _ := http.NewRequest("PUT", 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.put("https://api.fluid.app/api/company/v2026-10/member-sites/{id}/files/{path}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"member_site_file\": {\n \"content\": \"{{ content_for_layout }}\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/company/v2026-10/member-sites/{id}/files/{path}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"member_site_file\": {\n \"content\": \"{{ content_for_layout }}\"\n }\n}"
response = http.request(request)
puts response.read_body{
"member_site_file": {
"path": "layouts/site.liquid",
"content": "{{ content_for_layout }}",
"lock_version": null,
"version": "4c4127c0f28a648e32ccb71b3b6d1c7cf4c8c8cf8d4459c25a14dfab782049de"
},
"status": 200,
"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.
The theme-style path of the file, with its slash: layouts/<name>.liquid, sections/<name>.liquid, snippets/<name>.liquid, pages/<slug>.liquid (pages/index.liquid for the home page), assets/<file> (a css, js, json, txt or html file), config/settings.json, config/menus.json, config/pages.json or config/access.json. Names use lowercase letters, digits, hyphens and underscores, with no subfolders. Any other path is refused with 422.
Pattern:
^.+$Body
application/json
The content of a file. The path is in the URL.
Show child attributes
Show child attributes
⌘I
Write a site file
curl --request PUT \
--url https://api.fluid.app/api/company/v2026-10/member-sites/{id}/files/{path} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"member_site_file": {
"content": "{{ content_for_layout }}"
}
}
'import requests
url = "https://api.fluid.app/api/company/v2026-10/member-sites/{id}/files/{path}"
payload = { "member_site_file": { "content": "{{ content_for_layout }}" } }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({member_site_file: {content: '{{ content_for_layout }}'}})
};
fetch('https://api.fluid.app/api/company/v2026-10/member-sites/{id}/files/{path}', 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}/files/{path}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'member_site_file' => [
'content' => '{{ content_for_layout }}'
]
]),
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}/files/{path}"
payload := strings.NewReader("{\n \"member_site_file\": {\n \"content\": \"{{ content_for_layout }}\"\n }\n}")
req, _ := http.NewRequest("PUT", 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.put("https://api.fluid.app/api/company/v2026-10/member-sites/{id}/files/{path}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"member_site_file\": {\n \"content\": \"{{ content_for_layout }}\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/company/v2026-10/member-sites/{id}/files/{path}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"member_site_file\": {\n \"content\": \"{{ content_for_layout }}\"\n }\n}"
response = http.request(request)
puts response.read_body{
"member_site_file": {
"path": "layouts/site.liquid",
"content": "{{ content_for_layout }}",
"lock_version": null,
"version": "4c4127c0f28a648e32ccb71b3b6d1c7cf4c8c8cf8d4459c25a14dfab782049de"
},
"status": 200,
"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"
}
}