Reset branding to the platform default
Clear every branding override in one step, so every surface shows the platform default. Takes your last read’s revision to catch concurrent edits.
DELETE
/
branding
curl --request DELETE "$MITHUNAI_URL/mithunai/api/v1/branding?revision=4" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
response = requests.delete(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/branding",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
params={"revision": 4},
timeout=60,
)
response.raise_for_status()
print(response.json())
const params = new URLSearchParams({ revision: '4' })
const response = await fetch(`${process.env.MITHUNAI_URL}/mithunai/api/v1/branding?${params}`, {
method: 'DELETE',
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
})
console.log(await response.json())
{
"layer": {},
"revision": 5,
"configured": true,
"updatedAt": "2026-09-24T11:02:37.640118+00:00",
"updatedBy": "8d3f6a21-4c9e-4b07-a1d5-e62f0b9c7a48"
}
{
"code": "validation_error",
"message": "A revision is required. Reload the branding settings and try again."
}
{ "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." }
Clears the whole layer in one step. Afterwards
layer is {} and every surface shows the platform default. configured stays true, because branding has now been saved at least once.
revision is required and travels as a query parameter. Send the revision from your last read. If anyone has saved or reset branding since, the request fails with 409 and nothing is changed. A successful reset returns revision increased by one.
Resetting branding requires the owner or admin role. Other roles receive 403. See Branding.
integer
required
The
revision from your last read, as decimal digits. A missing or non-numeric value returns
400; a stale value returns 409.Response
Returns200 OK with the reset branding.
object
required
Always
{} after a reset.integer
required
The new revision.
boolean
required
true after a reset.string
required
When the reset happened, ISO 8601 in UTC.
string | null
required
Identifier of the user or API key that performed the reset.
curl --request DELETE "$MITHUNAI_URL/mithunai/api/v1/branding?revision=4" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
response = requests.delete(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/branding",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
params={"revision": 4},
timeout=60,
)
response.raise_for_status()
print(response.json())
const params = new URLSearchParams({ revision: '4' })
const response = await fetch(`${process.env.MITHUNAI_URL}/mithunai/api/v1/branding?${params}`, {
method: 'DELETE',
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
})
console.log(await response.json())
{
"layer": {},
"revision": 5,
"configured": true,
"updatedAt": "2026-09-24T11:02:37.640118+00:00",
"updatedBy": "8d3f6a21-4c9e-4b07-a1d5-e62f0b9c7a48"
}
{
"code": "validation_error",
"message": "A revision is required. Reload the branding settings and try again."
}
{ "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." }
Last modified on November 7, 2026
curl --request DELETE "$MITHUNAI_URL/mithunai/api/v1/branding?revision=4" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
response = requests.delete(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/branding",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
params={"revision": 4},
timeout=60,
)
response.raise_for_status()
print(response.json())
const params = new URLSearchParams({ revision: '4' })
const response = await fetch(`${process.env.MITHUNAI_URL}/mithunai/api/v1/branding?${params}`, {
method: 'DELETE',
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
})
console.log(await response.json())
{
"layer": {},
"revision": 5,
"configured": true,
"updatedAt": "2026-09-24T11:02:37.640118+00:00",
"updatedBy": "8d3f6a21-4c9e-4b07-a1d5-e62f0b9c7a48"
}
{
"code": "validation_error",
"message": "A revision is required. Reload the branding settings and try again."
}
{ "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." }