# Update branding property

Update a single branding property for a workspace or organization.

This endpoint uses a property-name/value pattern — each call updates one property at a time.

Supported propertyName values:

| propertyName | Type | Description |
|---|---|---|
| logo | string (URL) | Primary logo URL |
| logoW | string (URL) | White/light logo URL |
| colors | object | Brand color palette |
| company | object | Company metadata (name, domain, etc.) |
| about | string | About text used in AI video scripts |
| pronunciations | array | Custom pronunciation rules for AI voiceover |
| enabled | boolean | Enable or disable branding |

For colors, pass an object with colorPrimary, colorSecondary, and colorExtra hex values.

See the examples below for common update patterns.

Endpoint: PUT /auth/branding/entity
Version: 1.2.0
Security: ShuffllApiKey

## Request fields (application/json):

  - `workspace` (object)
    Target workspace. Required if updating workspace branding.

  - `workspace.id` (string)
    Workspace identifier
    Example: "693fb82afd8d1c43077ba0fe"

  - `organization` (object)
    Target organization. Required if updating organization branding (and no workspace is specified).

  - `organization.id` (string)
    Organization identifier
    Example: "693fb82afd8d1c43077ba0fb"

  - `propertyName` (string, required)
    The branding property to update
    Enum: "logo", "logoW", "colors", "company", "about", "pronunciations", "enabled"

  - `propertyValue` (any, required)
    The new value for the property. Shape depends on propertyName:
- logo / logoW: string (URL)
- colors: { colorPrimary: string, colorSecondary: string, colorExtra: string }
- company: { name: string, domain: string, geoLocation?: string }
- about: string
- pronunciations: array of pronunciation objects
- enabled: boolean
    Example: {"colorPrimary":"#1a1a2e","colorSecondary":"#16213e","colorExtra":"#0f3460"}

  - `socketIdToExclude` (string)
    Optional socket ID to exclude from real-time update notifications

## Response 400 fields (application/problem+json):

  - `type` (string)
    Example: "object"

  - `title` (string)
    Example: "Validation failed"

  - `message` (string)
    Example: "Bad Request"

## Response 401 fields (application/problem+json):

  - `type` (string)
    Example: "object"

  - `title` (string)
    Example: "Validation failed"

  - `message` (string)
    Example: "Bad Request"

## Response 404 fields (application/problem+json):

  - `type` (string)
    Example: "object"

  - `title` (string)
    Example: "Validation failed"

  - `message` (string)
    Example: "Bad Request"


## Response 200 fields