Brand guidelines
Update brand guidelines settings with null values (clear operation)
Updates the authenticated company’s brand guidelines. Send only the fields you want to change inside brand_guidelines; omitted fields keep their stored values and a null value clears a field. When fonts is sent it replaces the whole font list. Returns the updated brand guidelines. Requires a company admin with the company_settings update permission.
PATCH
/
api
/
settings
/
brand_guidelines
Update brand guidelines settings with null values (clear operation)
curl --request PATCH \
--url https://api.fluid.app/api/settings/brand_guidelines \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"brand_guidelines": {
"secondary_color": null,
"default_og_image": null,
"default_og_description": "Paper for every office in America, shipped from Scranton, PA.",
"fonts": [
{
"name": "Libre Franklin",
"file_url": "https://cdn.fluid.app/companies/1405/fonts/libre-franklin-600.woff2",
"file_id": 48213,
"format": "woff2",
"weight": "600",
"style": "normal",
"role": "heading"
}
]
}
}
'import requests
url = "https://api.fluid.app/api/settings/brand_guidelines"
payload = { "brand_guidelines": {
"secondary_color": None,
"default_og_image": None,
"default_og_description": "Paper for every office in America, shipped from Scranton, PA.",
"fonts": [
{
"name": "Libre Franklin",
"file_url": "https://cdn.fluid.app/companies/1405/fonts/libre-franklin-600.woff2",
"file_id": 48213,
"format": "woff2",
"weight": "600",
"style": "normal",
"role": "heading"
}
]
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
brand_guidelines: {
secondary_color: null,
default_og_image: null,
default_og_description: 'Paper for every office in America, shipped from Scranton, PA.',
fonts: [
{
name: 'Libre Franklin',
file_url: 'https://cdn.fluid.app/companies/1405/fonts/libre-franklin-600.woff2',
file_id: 48213,
format: 'woff2',
weight: '600',
style: 'normal',
role: 'heading'
}
]
}
})
};
fetch('https://api.fluid.app/api/settings/brand_guidelines', 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/settings/brand_guidelines",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'brand_guidelines' => [
'secondary_color' => null,
'default_og_image' => null,
'default_og_description' => 'Paper for every office in America, shipped from Scranton, PA.',
'fonts' => [
[
'name' => 'Libre Franklin',
'file_url' => 'https://cdn.fluid.app/companies/1405/fonts/libre-franklin-600.woff2',
'file_id' => 48213,
'format' => 'woff2',
'weight' => '600',
'style' => 'normal',
'role' => 'heading'
]
]
]
]),
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/settings/brand_guidelines"
payload := strings.NewReader("{\n \"brand_guidelines\": {\n \"secondary_color\": null,\n \"default_og_image\": null,\n \"default_og_description\": \"Paper for every office in America, shipped from Scranton, PA.\",\n \"fonts\": [\n {\n \"name\": \"Libre Franklin\",\n \"file_url\": \"https://cdn.fluid.app/companies/1405/fonts/libre-franklin-600.woff2\",\n \"file_id\": 48213,\n \"format\": \"woff2\",\n \"weight\": \"600\",\n \"style\": \"normal\",\n \"role\": \"heading\"\n }\n ]\n }\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://api.fluid.app/api/settings/brand_guidelines")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"brand_guidelines\": {\n \"secondary_color\": null,\n \"default_og_image\": null,\n \"default_og_description\": \"Paper for every office in America, shipped from Scranton, PA.\",\n \"fonts\": [\n {\n \"name\": \"Libre Franklin\",\n \"file_url\": \"https://cdn.fluid.app/companies/1405/fonts/libre-franklin-600.woff2\",\n \"file_id\": 48213,\n \"format\": \"woff2\",\n \"weight\": \"600\",\n \"style\": \"normal\",\n \"role\": \"heading\"\n }\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/settings/brand_guidelines")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"brand_guidelines\": {\n \"secondary_color\": null,\n \"default_og_image\": null,\n \"default_og_description\": \"Paper for every office in America, shipped from Scranton, PA.\",\n \"fonts\": [\n {\n \"name\": \"Libre Franklin\",\n \"file_url\": \"https://cdn.fluid.app/companies/1405/fonts/libre-franklin-600.woff2\",\n \"file_id\": 48213,\n \"format\": \"woff2\",\n \"weight\": \"600\",\n \"style\": \"normal\",\n \"role\": \"heading\"\n }\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"id": 1405,
"name": "Dunder Mifflin Paper Company",
"logo_url": "https://cdn.fluid.app/companies/1405/brand/dunder-mifflin-logo.png",
"icon_url": "https://cdn.fluid.app/companies/1405/brand/dunder-mifflin-icon.png",
"favicon_url": "https://cdn.fluid.app/companies/1405/brand/favicon.ico",
"color": "#1F4E8C",
"secondary_color": null,
"default_og_image": null,
"default_fallback_image": "https://cdn.fluid.app/companies/1405/brand/fallback-paper-stack.jpg",
"default_og_description": "Paper for every office in America, shipped from Scranton, PA.",
"brand_md": "# Dunder Mifflin brand voice\n\nFriendly, dependable, and proudly Scranton. Write like a helpful sales rep, not a memo.",
"fonts": [
{
"name": "Libre Franklin",
"file_url": "https://cdn.fluid.app/companies/1405/fonts/libre-franklin-600.woff2",
"file_id": 48213,
"format": "woff2",
"weight": "600",
"style": "normal",
"role": "heading"
}
],
"meta": {
"request_id": "c4f1b9e2-7a3d-4e8b-9f21-5d6a0b3e8c47",
"timestamp": "2026-09-14T15:32:08Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}Authorizations
Bearer token authentication
Body
application/json
Show child attributes
Show child attributes
Response
Success
Show child attributes
Show child attributes
Show child attributes
Show child attributes
⌘I
Update brand guidelines settings with null values (clear operation)
curl --request PATCH \
--url https://api.fluid.app/api/settings/brand_guidelines \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"brand_guidelines": {
"secondary_color": null,
"default_og_image": null,
"default_og_description": "Paper for every office in America, shipped from Scranton, PA.",
"fonts": [
{
"name": "Libre Franklin",
"file_url": "https://cdn.fluid.app/companies/1405/fonts/libre-franklin-600.woff2",
"file_id": 48213,
"format": "woff2",
"weight": "600",
"style": "normal",
"role": "heading"
}
]
}
}
'import requests
url = "https://api.fluid.app/api/settings/brand_guidelines"
payload = { "brand_guidelines": {
"secondary_color": None,
"default_og_image": None,
"default_og_description": "Paper for every office in America, shipped from Scranton, PA.",
"fonts": [
{
"name": "Libre Franklin",
"file_url": "https://cdn.fluid.app/companies/1405/fonts/libre-franklin-600.woff2",
"file_id": 48213,
"format": "woff2",
"weight": "600",
"style": "normal",
"role": "heading"
}
]
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
brand_guidelines: {
secondary_color: null,
default_og_image: null,
default_og_description: 'Paper for every office in America, shipped from Scranton, PA.',
fonts: [
{
name: 'Libre Franklin',
file_url: 'https://cdn.fluid.app/companies/1405/fonts/libre-franklin-600.woff2',
file_id: 48213,
format: 'woff2',
weight: '600',
style: 'normal',
role: 'heading'
}
]
}
})
};
fetch('https://api.fluid.app/api/settings/brand_guidelines', 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/settings/brand_guidelines",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'brand_guidelines' => [
'secondary_color' => null,
'default_og_image' => null,
'default_og_description' => 'Paper for every office in America, shipped from Scranton, PA.',
'fonts' => [
[
'name' => 'Libre Franklin',
'file_url' => 'https://cdn.fluid.app/companies/1405/fonts/libre-franklin-600.woff2',
'file_id' => 48213,
'format' => 'woff2',
'weight' => '600',
'style' => 'normal',
'role' => 'heading'
]
]
]
]),
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/settings/brand_guidelines"
payload := strings.NewReader("{\n \"brand_guidelines\": {\n \"secondary_color\": null,\n \"default_og_image\": null,\n \"default_og_description\": \"Paper for every office in America, shipped from Scranton, PA.\",\n \"fonts\": [\n {\n \"name\": \"Libre Franklin\",\n \"file_url\": \"https://cdn.fluid.app/companies/1405/fonts/libre-franklin-600.woff2\",\n \"file_id\": 48213,\n \"format\": \"woff2\",\n \"weight\": \"600\",\n \"style\": \"normal\",\n \"role\": \"heading\"\n }\n ]\n }\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://api.fluid.app/api/settings/brand_guidelines")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"brand_guidelines\": {\n \"secondary_color\": null,\n \"default_og_image\": null,\n \"default_og_description\": \"Paper for every office in America, shipped from Scranton, PA.\",\n \"fonts\": [\n {\n \"name\": \"Libre Franklin\",\n \"file_url\": \"https://cdn.fluid.app/companies/1405/fonts/libre-franklin-600.woff2\",\n \"file_id\": 48213,\n \"format\": \"woff2\",\n \"weight\": \"600\",\n \"style\": \"normal\",\n \"role\": \"heading\"\n }\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/settings/brand_guidelines")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"brand_guidelines\": {\n \"secondary_color\": null,\n \"default_og_image\": null,\n \"default_og_description\": \"Paper for every office in America, shipped from Scranton, PA.\",\n \"fonts\": [\n {\n \"name\": \"Libre Franklin\",\n \"file_url\": \"https://cdn.fluid.app/companies/1405/fonts/libre-franklin-600.woff2\",\n \"file_id\": 48213,\n \"format\": \"woff2\",\n \"weight\": \"600\",\n \"style\": \"normal\",\n \"role\": \"heading\"\n }\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"id": 1405,
"name": "Dunder Mifflin Paper Company",
"logo_url": "https://cdn.fluid.app/companies/1405/brand/dunder-mifflin-logo.png",
"icon_url": "https://cdn.fluid.app/companies/1405/brand/dunder-mifflin-icon.png",
"favicon_url": "https://cdn.fluid.app/companies/1405/brand/favicon.ico",
"color": "#1F4E8C",
"secondary_color": null,
"default_og_image": null,
"default_fallback_image": "https://cdn.fluid.app/companies/1405/brand/fallback-paper-stack.jpg",
"default_og_description": "Paper for every office in America, shipped from Scranton, PA.",
"brand_md": "# Dunder Mifflin brand voice\n\nFriendly, dependable, and proudly Scranton. Write like a helpful sales rep, not a memo.",
"fonts": [
{
"name": "Libre Franklin",
"file_url": "https://cdn.fluid.app/companies/1405/fonts/libre-franklin-600.woff2",
"file_id": 48213,
"format": "woff2",
"weight": "600",
"style": "normal",
"role": "heading"
}
],
"meta": {
"request_id": "c4f1b9e2-7a3d-4e8b-9f21-5d6a0b3e8c47",
"timestamp": "2026-09-14T15:32:08Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}