Update workspace brand
curl --request PUT \
--url https://app.base44.com/api/workspace/{workspace_id}/brands/{brand_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"kit": {
"description": "A family furniture workshop that builds solid oak tables and chairs to order.",
"logo": {
"altText": "Nordwind logo",
"url": "https://media.base44.com/images/public/nordwind-logo.png"
},
"tagLine": "Furniture built to last",
"title": "Nordwind",
"toneOfVoice": [
"Warm",
"Plain-spoken"
],
"values": [
"Craft",
"Honesty",
"Durability"
]
},
"design_system": {
"tokens": {
"colors": [
{
"label": "Primary",
"token": "primary",
"value": "#0B7A3B"
},
{
"label": "Background",
"token": "background",
"value": "#FAF7F2"
}
],
"fonts": [
{
"family": "Fraunces",
"role": "heading"
},
{
"family": "Inter",
"role": "body"
}
]
}
}
}
'import requests
url = "https://app.base44.com/api/workspace/{workspace_id}/brands/{brand_id}"
payload = {
"kit": {
"description": "A family furniture workshop that builds solid oak tables and chairs to order.",
"logo": {
"altText": "Nordwind logo",
"url": "https://media.base44.com/images/public/nordwind-logo.png"
},
"tagLine": "Furniture built to last",
"title": "Nordwind",
"toneOfVoice": ["Warm", "Plain-spoken"],
"values": ["Craft", "Honesty", "Durability"]
},
"design_system": { "tokens": {
"colors": [
{
"label": "Primary",
"token": "primary",
"value": "#0B7A3B"
},
{
"label": "Background",
"token": "background",
"value": "#FAF7F2"
}
],
"fonts": [
{
"family": "Fraunces",
"role": "heading"
},
{
"family": "Inter",
"role": "body"
}
]
} }
}
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({
kit: {
description: 'A family furniture workshop that builds solid oak tables and chairs to order.',
logo: {
altText: 'Nordwind logo',
url: 'https://media.base44.com/images/public/nordwind-logo.png'
},
tagLine: 'Furniture built to last',
title: 'Nordwind',
toneOfVoice: ['Warm', 'Plain-spoken'],
values: ['Craft', 'Honesty', 'Durability']
},
design_system: {
tokens: {
colors: [
{label: 'Primary', token: 'primary', value: '#0B7A3B'},
{label: 'Background', token: 'background', value: '#FAF7F2'}
],
fonts: [{family: 'Fraunces', role: 'heading'}, {family: 'Inter', role: 'body'}]
}
}
})
};
fetch('https://app.base44.com/api/workspace/{workspace_id}/brands/{brand_id}', 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://app.base44.com/api/workspace/{workspace_id}/brands/{brand_id}",
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([
'kit' => [
'description' => 'A family furniture workshop that builds solid oak tables and chairs to order.',
'logo' => [
'altText' => 'Nordwind logo',
'url' => 'https://media.base44.com/images/public/nordwind-logo.png'
],
'tagLine' => 'Furniture built to last',
'title' => 'Nordwind',
'toneOfVoice' => [
'Warm',
'Plain-spoken'
],
'values' => [
'Craft',
'Honesty',
'Durability'
]
],
'design_system' => [
'tokens' => [
'colors' => [
[
'label' => 'Primary',
'token' => 'primary',
'value' => '#0B7A3B'
],
[
'label' => 'Background',
'token' => 'background',
'value' => '#FAF7F2'
]
],
'fonts' => [
[
'family' => 'Fraunces',
'role' => 'heading'
],
[
'family' => 'Inter',
'role' => 'body'
]
]
]
]
]),
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://app.base44.com/api/workspace/{workspace_id}/brands/{brand_id}"
payload := strings.NewReader("{\n \"kit\": {\n \"description\": \"A family furniture workshop that builds solid oak tables and chairs to order.\",\n \"logo\": {\n \"altText\": \"Nordwind logo\",\n \"url\": \"https://media.base44.com/images/public/nordwind-logo.png\"\n },\n \"tagLine\": \"Furniture built to last\",\n \"title\": \"Nordwind\",\n \"toneOfVoice\": [\n \"Warm\",\n \"Plain-spoken\"\n ],\n \"values\": [\n \"Craft\",\n \"Honesty\",\n \"Durability\"\n ]\n },\n \"design_system\": {\n \"tokens\": {\n \"colors\": [\n {\n \"label\": \"Primary\",\n \"token\": \"primary\",\n \"value\": \"#0B7A3B\"\n },\n {\n \"label\": \"Background\",\n \"token\": \"background\",\n \"value\": \"#FAF7F2\"\n }\n ],\n \"fonts\": [\n {\n \"family\": \"Fraunces\",\n \"role\": \"heading\"\n },\n {\n \"family\": \"Inter\",\n \"role\": \"body\"\n }\n ]\n }\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://app.base44.com/api/workspace/{workspace_id}/brands/{brand_id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"kit\": {\n \"description\": \"A family furniture workshop that builds solid oak tables and chairs to order.\",\n \"logo\": {\n \"altText\": \"Nordwind logo\",\n \"url\": \"https://media.base44.com/images/public/nordwind-logo.png\"\n },\n \"tagLine\": \"Furniture built to last\",\n \"title\": \"Nordwind\",\n \"toneOfVoice\": [\n \"Warm\",\n \"Plain-spoken\"\n ],\n \"values\": [\n \"Craft\",\n \"Honesty\",\n \"Durability\"\n ]\n },\n \"design_system\": {\n \"tokens\": {\n \"colors\": [\n {\n \"label\": \"Primary\",\n \"token\": \"primary\",\n \"value\": \"#0B7A3B\"\n },\n {\n \"label\": \"Background\",\n \"token\": \"background\",\n \"value\": \"#FAF7F2\"\n }\n ],\n \"fonts\": [\n {\n \"family\": \"Fraunces\",\n \"role\": \"heading\"\n },\n {\n \"family\": \"Inter\",\n \"role\": \"body\"\n }\n ]\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.base44.com/api/workspace/{workspace_id}/brands/{brand_id}")
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 \"kit\": {\n \"description\": \"A family furniture workshop that builds solid oak tables and chairs to order.\",\n \"logo\": {\n \"altText\": \"Nordwind logo\",\n \"url\": \"https://media.base44.com/images/public/nordwind-logo.png\"\n },\n \"tagLine\": \"Furniture built to last\",\n \"title\": \"Nordwind\",\n \"toneOfVoice\": [\n \"Warm\",\n \"Plain-spoken\"\n ],\n \"values\": [\n \"Craft\",\n \"Honesty\",\n \"Durability\"\n ]\n },\n \"design_system\": {\n \"tokens\": {\n \"colors\": [\n {\n \"label\": \"Primary\",\n \"token\": \"primary\",\n \"value\": \"#0B7A3B\"\n },\n {\n \"label\": \"Background\",\n \"token\": \"background\",\n \"value\": \"#FAF7F2\"\n }\n ],\n \"fonts\": [\n {\n \"family\": \"Fraunces\",\n \"role\": \"heading\"\n },\n {\n \"family\": \"Inter\",\n \"role\": \"body\"\n }\n ]\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"message": "Brand 'Nordwind' saved"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Brands
Update workspace brand
This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
Replaces a brand’s kit and design system. Send the whole brand: design_system replaces the stored one, and leaving it out clears it.
kit.title becomes the brand’s title, and it can’t exactly match another brand’s title in the workspace. kit and design_system are stored as you send them, up to 1 MB together.
Updating doesn’t change the brand’s status. Don’t update a brand while it’s generating, because the finished generation replaces your changes.
This is limited to 60 requests per minute, shared with the other endpoints that change brands, except generating one. A signed-in session has its own limit, and every personal access token for the workspace shares one. Some workspaces have a different limit.
Call this as an owner or admin of the workspace, with a personal access token for that workspace sent as a Bearer token, or from a signed-in session. A read-only token is refused, and workspace API keys aren’t accepted.
The response includes fields beyond the ones documented here. Don’t rely on undocumented response fields, as they can change at any time.
PUT
/
api
/
workspace
/
{workspace_id}
/
brands
/
{brand_id}
Update workspace brand
curl --request PUT \
--url https://app.base44.com/api/workspace/{workspace_id}/brands/{brand_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"kit": {
"description": "A family furniture workshop that builds solid oak tables and chairs to order.",
"logo": {
"altText": "Nordwind logo",
"url": "https://media.base44.com/images/public/nordwind-logo.png"
},
"tagLine": "Furniture built to last",
"title": "Nordwind",
"toneOfVoice": [
"Warm",
"Plain-spoken"
],
"values": [
"Craft",
"Honesty",
"Durability"
]
},
"design_system": {
"tokens": {
"colors": [
{
"label": "Primary",
"token": "primary",
"value": "#0B7A3B"
},
{
"label": "Background",
"token": "background",
"value": "#FAF7F2"
}
],
"fonts": [
{
"family": "Fraunces",
"role": "heading"
},
{
"family": "Inter",
"role": "body"
}
]
}
}
}
'import requests
url = "https://app.base44.com/api/workspace/{workspace_id}/brands/{brand_id}"
payload = {
"kit": {
"description": "A family furniture workshop that builds solid oak tables and chairs to order.",
"logo": {
"altText": "Nordwind logo",
"url": "https://media.base44.com/images/public/nordwind-logo.png"
},
"tagLine": "Furniture built to last",
"title": "Nordwind",
"toneOfVoice": ["Warm", "Plain-spoken"],
"values": ["Craft", "Honesty", "Durability"]
},
"design_system": { "tokens": {
"colors": [
{
"label": "Primary",
"token": "primary",
"value": "#0B7A3B"
},
{
"label": "Background",
"token": "background",
"value": "#FAF7F2"
}
],
"fonts": [
{
"family": "Fraunces",
"role": "heading"
},
{
"family": "Inter",
"role": "body"
}
]
} }
}
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({
kit: {
description: 'A family furniture workshop that builds solid oak tables and chairs to order.',
logo: {
altText: 'Nordwind logo',
url: 'https://media.base44.com/images/public/nordwind-logo.png'
},
tagLine: 'Furniture built to last',
title: 'Nordwind',
toneOfVoice: ['Warm', 'Plain-spoken'],
values: ['Craft', 'Honesty', 'Durability']
},
design_system: {
tokens: {
colors: [
{label: 'Primary', token: 'primary', value: '#0B7A3B'},
{label: 'Background', token: 'background', value: '#FAF7F2'}
],
fonts: [{family: 'Fraunces', role: 'heading'}, {family: 'Inter', role: 'body'}]
}
}
})
};
fetch('https://app.base44.com/api/workspace/{workspace_id}/brands/{brand_id}', 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://app.base44.com/api/workspace/{workspace_id}/brands/{brand_id}",
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([
'kit' => [
'description' => 'A family furniture workshop that builds solid oak tables and chairs to order.',
'logo' => [
'altText' => 'Nordwind logo',
'url' => 'https://media.base44.com/images/public/nordwind-logo.png'
],
'tagLine' => 'Furniture built to last',
'title' => 'Nordwind',
'toneOfVoice' => [
'Warm',
'Plain-spoken'
],
'values' => [
'Craft',
'Honesty',
'Durability'
]
],
'design_system' => [
'tokens' => [
'colors' => [
[
'label' => 'Primary',
'token' => 'primary',
'value' => '#0B7A3B'
],
[
'label' => 'Background',
'token' => 'background',
'value' => '#FAF7F2'
]
],
'fonts' => [
[
'family' => 'Fraunces',
'role' => 'heading'
],
[
'family' => 'Inter',
'role' => 'body'
]
]
]
]
]),
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://app.base44.com/api/workspace/{workspace_id}/brands/{brand_id}"
payload := strings.NewReader("{\n \"kit\": {\n \"description\": \"A family furniture workshop that builds solid oak tables and chairs to order.\",\n \"logo\": {\n \"altText\": \"Nordwind logo\",\n \"url\": \"https://media.base44.com/images/public/nordwind-logo.png\"\n },\n \"tagLine\": \"Furniture built to last\",\n \"title\": \"Nordwind\",\n \"toneOfVoice\": [\n \"Warm\",\n \"Plain-spoken\"\n ],\n \"values\": [\n \"Craft\",\n \"Honesty\",\n \"Durability\"\n ]\n },\n \"design_system\": {\n \"tokens\": {\n \"colors\": [\n {\n \"label\": \"Primary\",\n \"token\": \"primary\",\n \"value\": \"#0B7A3B\"\n },\n {\n \"label\": \"Background\",\n \"token\": \"background\",\n \"value\": \"#FAF7F2\"\n }\n ],\n \"fonts\": [\n {\n \"family\": \"Fraunces\",\n \"role\": \"heading\"\n },\n {\n \"family\": \"Inter\",\n \"role\": \"body\"\n }\n ]\n }\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://app.base44.com/api/workspace/{workspace_id}/brands/{brand_id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"kit\": {\n \"description\": \"A family furniture workshop that builds solid oak tables and chairs to order.\",\n \"logo\": {\n \"altText\": \"Nordwind logo\",\n \"url\": \"https://media.base44.com/images/public/nordwind-logo.png\"\n },\n \"tagLine\": \"Furniture built to last\",\n \"title\": \"Nordwind\",\n \"toneOfVoice\": [\n \"Warm\",\n \"Plain-spoken\"\n ],\n \"values\": [\n \"Craft\",\n \"Honesty\",\n \"Durability\"\n ]\n },\n \"design_system\": {\n \"tokens\": {\n \"colors\": [\n {\n \"label\": \"Primary\",\n \"token\": \"primary\",\n \"value\": \"#0B7A3B\"\n },\n {\n \"label\": \"Background\",\n \"token\": \"background\",\n \"value\": \"#FAF7F2\"\n }\n ],\n \"fonts\": [\n {\n \"family\": \"Fraunces\",\n \"role\": \"heading\"\n },\n {\n \"family\": \"Inter\",\n \"role\": \"body\"\n }\n ]\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.base44.com/api/workspace/{workspace_id}/brands/{brand_id}")
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 \"kit\": {\n \"description\": \"A family furniture workshop that builds solid oak tables and chairs to order.\",\n \"logo\": {\n \"altText\": \"Nordwind logo\",\n \"url\": \"https://media.base44.com/images/public/nordwind-logo.png\"\n },\n \"tagLine\": \"Furniture built to last\",\n \"title\": \"Nordwind\",\n \"toneOfVoice\": [\n \"Warm\",\n \"Plain-spoken\"\n ],\n \"values\": [\n \"Craft\",\n \"Honesty\",\n \"Durability\"\n ]\n },\n \"design_system\": {\n \"tokens\": {\n \"colors\": [\n {\n \"label\": \"Primary\",\n \"token\": \"primary\",\n \"value\": \"#0B7A3B\"\n },\n {\n \"label\": \"Background\",\n \"token\": \"background\",\n \"value\": \"#FAF7F2\"\n }\n ],\n \"fonts\": [\n {\n \"family\": \"Fraunces\",\n \"role\": \"heading\"\n },\n {\n \"family\": \"Inter\",\n \"role\": \"body\"\n }\n ]\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"message": "Brand 'Nordwind' saved"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Authorizations
Personal access token, sent as Authorization: Bearer <token>.
Body
application/json
The brand's identity. It needs a non-empty title, which becomes the brand's title, and a description. Brands Base44 generates also carry tagLine, values, toneOfVoice, designGuidelines, componentStyle, and a logo with its url. Nothing else in it is checked.
Example:
{
"description": "A family furniture workshop that builds solid oak tables and chairs to order.",
"logo": {
"altText": "Nordwind logo",
"url": "https://media.base44.com/images/public/nordwind-logo.png"
},
"tagLine": "Furniture built to last",
"title": "Nordwind",
"toneOfVoice": ["Warm", "Plain-spoken"],
"values": ["Craft", "Honesty", "Durability"]
}
The brand's design system: its tokens, such as colors and fonts, and its component sections. It's stored as you send it. When you include tokens, send it as an object. Defaults to an empty object.
Example:
{
"tokens": {
"colors": [
{
"label": "Primary",
"token": "primary",
"value": "#0B7A3B"
},
{
"label": "Background",
"token": "background",
"value": "#FAF7F2"
}
],
"fonts": [
{ "family": "Fraunces", "role": "heading" },
{ "family": "Inter", "role": "body" }
]
}
}
Was this page helpful?