Replace your whole branding layer at once

curl --request PUT "$MITHUNAI_URL/mithunai/api/v1/branding" \
  --header "Authorization: Bearer $MITHUNAI_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "revision": 3,
    "layer": {
      "identity": { "productName": "Northwind Answers", "companyName": "Northwind Traders" },
      "assets": { "logoLight": "https://cdn.northwind.example/brand/logo-light.svg" },
      "theme": {
        "colors": { "light": { "brand": "#1F6FEB", "brandHover": "#1A5FCC" } },
        "modeDefault": "system"
      },
      "domains": { "supportUrl": "https://support.northwind.example" },
      "surfaces": { "widget": { "showBranding": false } }
    }
  }'

import os, requests

layer = {
    "identity": {"productName": "Northwind Answers", "companyName": "Northwind Traders"},
    "assets": {"logoLight": "https://cdn.northwind.example/brand/logo-light.svg"},
    "theme": {
        "colors": {"light": {"brand": "#1F6FEB", "brandHover": "#1A5FCC"}},
        "modeDefault": "system",
    },
    "domains": {"supportUrl": "https://support.northwind.example"},
    "surfaces": {"widget": {"showBranding": False}},
}

response = requests.put(
    f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/branding",
    headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
    json={"revision": 3, "layer": layer},
    timeout=60,
)
response.raise_for_status()
print(response.json())

const layer = {
  identity: { productName: 'Northwind Answers', companyName: 'Northwind Traders' },
  assets: { logoLight: 'https://cdn.northwind.example/brand/logo-light.svg' },
  theme: {
    colors: { light: { brand: '#1F6FEB', brandHover: '#1A5FCC' } },
    modeDefault: 'system',
  },
  domains: { supportUrl: 'https://support.northwind.example' },
  surfaces: { widget: { showBranding: false } },
}

const response = await fetch(`${process.env.MITHUNAI_URL}/mithunai/api/v1/branding`, {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ revision: 3, layer }),
})
console.log(await response.json())

{
  "layer": {
    "identity": {
      "productName": "Northwind Answers",
      "companyName": "Northwind Traders"
    },
    "assets": {
      "logoLight": "https://cdn.northwind.example/brand/logo-light.svg"
    },
    "theme": {
      "colors": {
        "light": {
          "brand": "#1F6FEB",
          "brandHover": "#1A5FCC"
        }
      },
      "modeDefault": "system"
    },
    "domains": {
      "supportUrl": "https://support.northwind.example"
    },
    "surfaces": {
      "widget": {
        "showBranding": false
      }
    }
  },
  "revision": 4,
  "configured": true,
  "updatedAt": "2026-09-24T10:48:13.209577+00:00",
  "updatedBy": "8d3f6a21-4c9e-4b07-a1d5-e62f0b9c7a48"
}

{
  "code": "validation_error",
  "message": "Colours must be a hex value such as #4636D9, or an rgb(), rgba(), hsl() or hsla() value."
}

{ "code": "authorization_error", "message": "You do not have permission to perform this action." }

{ "code": "conflict", "message": "The branding was changed by someone else. Reload and try again." }