---
title: "Update a single brand identity"
method: PATCH
path: "/v1/brand-identities/{brandIdentityId}"
tags: ["Content"]
---

# Update a single brand identity

`PATCH /v1/brand-identities/{brandIdentityId}`

Updates brand identity fields. Pass isDefault: true to make the target brand identity the organization's default.

## Path parameters

- `brandIdentityId` string, required

## Request body

- object
  - `name` string
  - `websiteUrl` string
  - `companyName` string, nullable
  - `companyDescription` string, nullable
  - `toneProfile` 'Conversational' | 'Professional' | 'Casual' | 'Formal' | 'null', nullable — Set a preset tone profile. When provided without customTone, any saved custom tone is cleared.
  - `customTone` string, nullable — Provide a custom tone override. Send an empty string or null to clear it.
  - `customInstructions` string, nullable
  - `audience` string, nullable
  - `language` 'English' | 'Spanish' | 'French' | 'German' | 'Portuguese' | 'Dutch' | 'Italian' | 'Japanese' | 'Korean' | 'Chinese' | 'Arabic' | 'Hindi' | 'Russian' | 'Turkish' | 'Polish' | 'Swedish' | 'Danish' | 'Norwegian' | 'Finnish' | 'Czech' | 'Romanian' | 'Hungarian' | 'Greek' | 'Thai' | 'Vietnamese' | 'Indonesian' | 'Ukrainian' | 'Hebrew' | 'null', nullable
  - `isDefault` true — Set this brand identity as the organization's default. Only true is accepted.

## Response `200`

Brand identity updated successfully

- object
  - `organization` object, required
    - `id` string, required
    - `slug` string, required
    - `name` string, required
    - `logo` string, nullable, required
  - `brandIdentity` object, required
    - `id` string, required
    - `name` string, required
    - `isDefault` boolean, required
    - `websiteUrl` string, required
    - `companyName` string, nullable, required
    - `companyDescription` string, nullable, required
    - `toneProfile` string, nullable, required
    - `customTone` string, nullable, required
    - `customInstructions` string, nullable, required
    - `audience` string, nullable, required
    - `language` string, nullable, required
    - `createdAt` string, required
    - `updatedAt` string, required

## Other responses

- `400` — Invalid path params or request body
- `401` — Missing or invalid API key
- `403` — Forbidden
- `404` — Brand identity not found
- `409` — Brand identity name already exists
- `503` — Authentication service unavailable

---

[API](https://skmtc.net/usenotra/apis/notra-api.md) · [All operations](https://skmtc.net/usenotra/apis/notra-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usenotra/notra-api/versions/4e07496e06b0/schema)