> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mithunai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Reset branding to the platform default

> Clear every override in one step, so every surface shows the platform default again. Takes the revision from your last read, so a concurrent change is reported.

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](/administration/branding).

<ParamField query="revision" type="integer" required>
  The `revision` from your last read, as decimal digits. A missing or non-numeric value returns
  `400`; a stale value returns `409`.
</ParamField>

## Response

Returns `200 OK` with the reset branding.

<ResponseField name="layer" type="object" required>
  Always `{}` after a reset.
</ResponseField>

<ResponseField name="revision" type="integer" required>
  The new revision.
</ResponseField>

<ResponseField name="configured" type="boolean" required>
  `true` after a reset.
</ResponseField>

<ResponseField name="updatedAt" type="string" required>
  When the reset happened, ISO 8601 in UTC.
</ResponseField>

<ResponseField name="updatedBy" type="string | null" required>
  Identifier of the user or API key that performed the reset.
</ResponseField>

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl --request DELETE "$MITHUNAI_URL/arukz/api/v1/branding?revision=4" \
    --header "Authorization: Bearer $MITHUNAI_API_KEY"
  ```

  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  import os, requests

  response = requests.delete(
      f"{os.environ['MITHUNAI_URL']}/arukz/api/v1/branding",
      headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
      params={"revision": 4},
      timeout=60,
  )
  response.raise_for_status()
  print(response.json())
  ```

  ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
  const params = new URLSearchParams({ revision: '4' })
  const response = await fetch(`${process.env.MITHUNAI_URL}/arukz/api/v1/branding?${params}`, {
    method: 'DELETE',
    headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
  })
  console.log(await response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "layer": {},
    "revision": 5,
    "configured": true,
    "updatedAt": "2026-09-24T11:02:37.640118+00:00",
    "updatedBy": "8d3f6a21-4c9e-4b07-a1d5-e62f0b9c7a48"
  }
  ```

  ```json 400 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "code": "validation_error",
    "message": "A revision is required. Reload the branding settings and try again."
  }
  ```

  ```json 403 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  { "code": "authorization_error", "message": "You do not have permission to perform this action." }
  ```

  ```json 409 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  { "code": "conflict", "message": "The branding was changed by someone else. Reload and try again." }
  ```
</ResponseExample>