Change part of the Brand Kit
curl --request PATCH \
--url https://api.widgetic.com/v1/brand-kit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"cornerRadius": 0,
"instructions": "Use the dark color as the background always and the light color for titles."
}
'import requests
url = "https://api.widgetic.com/v1/brand-kit"
payload = {
"cornerRadius": 0,
"instructions": "Use the dark color as the background always and the light color for titles."
}
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({
cornerRadius: 0,
instructions: 'Use the dark color as the background always and the light color for titles.'
})
};
fetch('https://api.widgetic.com/v1/brand-kit', 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.widgetic.com/v1/brand-kit",
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([
'cornerRadius' => 0,
'instructions' => 'Use the dark color as the background always and the light color for titles.'
]),
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.widgetic.com/v1/brand-kit"
payload := strings.NewReader("{\n \"cornerRadius\": 0,\n \"instructions\": \"Use the dark color as the background always and the light color for titles.\"\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.widgetic.com/v1/brand-kit")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"cornerRadius\": 0,\n \"instructions\": \"Use the dark color as the background always and the light color for titles.\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.widgetic.com/v1/brand-kit")
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 \"cornerRadius\": 0,\n \"instructions\": \"Use the dark color as the background always and the light color for titles.\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"owner": {},
"isDefault": true,
"canEdit": true,
"version": 42,
"tokens": null,
"assets": [
"Example BrandKitAssetView"
],
"figmaSource": null,
"updatedAt": "2026-01-15T09:30:00.000Z",
"updatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"warnings": []
},
"meta": {
"page": 1,
"size": 20,
"total": 135,
"limit": 20,
"offset": 0,
"hasNextPage": true,
"hasPreviousPage": false,
"nextCursor": "<string>",
"warnings": [
"<string>"
]
}
}{
"success": false,
"message": "<string>",
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Composition not found",
"timestamp": "2026-10-15T10:00:00.000Z",
"param": "name",
"docUrl": "<string>",
"suggestedAction": "<string>",
"retryAfter": 60,
"details": {},
"correlationId": "req_123e4567-e89b-12d3-a456-426614174000"
}
}{
"success": false,
"message": "<string>",
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Composition not found",
"timestamp": "2026-10-15T10:00:00.000Z",
"param": "name",
"docUrl": "<string>",
"suggestedAction": "<string>",
"retryAfter": 60,
"details": {},
"correlationId": "req_123e4567-e89b-12d3-a456-426614174000"
}
}{
"success": false,
"message": "<string>",
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Composition not found",
"timestamp": "2026-10-15T10:00:00.000Z",
"param": "name",
"docUrl": "<string>",
"suggestedAction": "<string>",
"retryAfter": 60,
"details": {},
"correlationId": "req_123e4567-e89b-12d3-a456-426614174000"
}
}{
"success": false,
"message": "<string>",
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Composition not found",
"timestamp": "2026-10-15T10:00:00.000Z",
"param": "name",
"docUrl": "<string>",
"suggestedAction": "<string>",
"retryAfter": 60,
"details": {},
"correlationId": "req_123e4567-e89b-12d3-a456-426614174000"
}
}{
"success": false,
"message": "<string>",
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Composition not found",
"timestamp": "2026-10-15T10:00:00.000Z",
"param": "name",
"docUrl": "<string>",
"suggestedAction": "<string>",
"retryAfter": 60,
"details": {},
"correlationId": "req_123e4567-e89b-12d3-a456-426614174000"
}
}Brand Kit
Change part of the Brand Kit
Changes only what is sent: the colors, a font role, a spacing step, one corner radius (0 for square corners) or the style notes, and keeps the rest of the saved kit. An account that never saved a kit starts from Widgetic’s default one. The response lists what is worth fixing in warnings.
PATCH
/
brand-kit
Change part of the Brand Kit
curl --request PATCH \
--url https://api.widgetic.com/v1/brand-kit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"cornerRadius": 0,
"instructions": "Use the dark color as the background always and the light color for titles."
}
'import requests
url = "https://api.widgetic.com/v1/brand-kit"
payload = {
"cornerRadius": 0,
"instructions": "Use the dark color as the background always and the light color for titles."
}
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({
cornerRadius: 0,
instructions: 'Use the dark color as the background always and the light color for titles.'
})
};
fetch('https://api.widgetic.com/v1/brand-kit', 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.widgetic.com/v1/brand-kit",
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([
'cornerRadius' => 0,
'instructions' => 'Use the dark color as the background always and the light color for titles.'
]),
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.widgetic.com/v1/brand-kit"
payload := strings.NewReader("{\n \"cornerRadius\": 0,\n \"instructions\": \"Use the dark color as the background always and the light color for titles.\"\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.widgetic.com/v1/brand-kit")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"cornerRadius\": 0,\n \"instructions\": \"Use the dark color as the background always and the light color for titles.\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.widgetic.com/v1/brand-kit")
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 \"cornerRadius\": 0,\n \"instructions\": \"Use the dark color as the background always and the light color for titles.\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"owner": {},
"isDefault": true,
"canEdit": true,
"version": 42,
"tokens": null,
"assets": [
"Example BrandKitAssetView"
],
"figmaSource": null,
"updatedAt": "2026-01-15T09:30:00.000Z",
"updatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"warnings": []
},
"meta": {
"page": 1,
"size": 20,
"total": 135,
"limit": 20,
"offset": 0,
"hasNextPage": true,
"hasPreviousPage": false,
"nextCursor": "<string>",
"warnings": [
"<string>"
]
}
}{
"success": false,
"message": "<string>",
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Composition not found",
"timestamp": "2026-10-15T10:00:00.000Z",
"param": "name",
"docUrl": "<string>",
"suggestedAction": "<string>",
"retryAfter": 60,
"details": {},
"correlationId": "req_123e4567-e89b-12d3-a456-426614174000"
}
}{
"success": false,
"message": "<string>",
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Composition not found",
"timestamp": "2026-10-15T10:00:00.000Z",
"param": "name",
"docUrl": "<string>",
"suggestedAction": "<string>",
"retryAfter": 60,
"details": {},
"correlationId": "req_123e4567-e89b-12d3-a456-426614174000"
}
}{
"success": false,
"message": "<string>",
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Composition not found",
"timestamp": "2026-10-15T10:00:00.000Z",
"param": "name",
"docUrl": "<string>",
"suggestedAction": "<string>",
"retryAfter": 60,
"details": {},
"correlationId": "req_123e4567-e89b-12d3-a456-426614174000"
}
}{
"success": false,
"message": "<string>",
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Composition not found",
"timestamp": "2026-10-15T10:00:00.000Z",
"param": "name",
"docUrl": "<string>",
"suggestedAction": "<string>",
"retryAfter": 60,
"details": {},
"correlationId": "req_123e4567-e89b-12d3-a456-426614174000"
}
}{
"success": false,
"message": "<string>",
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Composition not found",
"timestamp": "2026-10-15T10:00:00.000Z",
"param": "name",
"docUrl": "<string>",
"suggestedAction": "<string>",
"retryAfter": 60,
"details": {},
"correlationId": "req_123e4567-e89b-12d3-a456-426614174000"
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Body
application/json
Changes part of the kit and leaves the rest as it is. Only the keys that are sent change.
The whole list of colors (it replaces the saved list).
Maximum array length:
24Show child attributes
Show child attributes
The text roles to change; the roles that are left out keep their font.
Show child attributes
Show child attributes
The spacing and radius steps to change; the steps that are left out keep their value.
Show child attributes
Show child attributes
One corner radius in pixels for the whole kit; the small, medium and large radii are made from it. 0 gives square corners. A radius step sent in spacing wins over the one made from this value.
Required range:
0 <= x <= 64The kit owner's style notes (see tokens.instructions). An empty string removes them.
Maximum string length:
500Refuse the change with a 409 when the kit was saved again since this version was read.
Response
The saved kit
Always true on a success.
Example:
true
Show child attributes
Show child attributes
Example:
{ "owner": {}, "isDefault": true, "canEdit": true, "version": 42, "tokens": null, "assets": ["Example BrandKitAssetView"], "figmaSource": null, "updatedAt": "2026-01-15T09:30:00.000Z", "updatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "warnings": [] }
Extra information about the answer: where a page sits in a list, the cursor of the next page, or warnings about a call that succeeded with a caveat.
Show child attributes
Show child attributes