---
title: "Update Brand"
method: PUT
path: "/management/v1/projects/{projectId}/branding/{brandingId}"
tags: ["Management"]
---

# Update Brand

`PUT /management/v1/projects/{projectId}/branding/{brandingId}`

## Request

- Base URL: `https://api.voucherify.io`
- URL: `https://api.voucherify.io/management/v1/projects/{projectId}/branding/{brandingId}`
- Auth: API key in header `X-Management-Id` and API key in header `X-Management-Token`

Updates a brand configuration.

Only the fields sent in the request will be updated. The fields omitted in the request will remain unchanged.

> 📘 White Labelling
>
> The white labelling settings which can be found in Project Settings > Brand Details and which are available only for Enterprise clients as a separate service can be configured only in the user interface.

## Request body

- ManagementProjectsBrandingUpdateRequestBody
  - `brand` object: Defines basic brand details.
    - `name` string: Defines brand name.
    - `privacy_policy_url` string, nullable: Defines the URL to the brand's privacy policy.
    - `terms_of_use_url` string, nullable: Defines the URL to the brand's terms of use.
    - `permission_reminder` string: Defines the message that is displayed to customers who opted in an email newsletter.
    - `website_url` string, nullable: Defines the URL to the brand's website.
  - `address` object: Defines the address details.
    - `street` string: Defines the brand's street.
    - `city` string: Defines the brand's city.
    - `postal` string, nullable: Defines the brand's postal code
    - `state` string: Defines the brand's state or similar administrative area.
    - `country` string: Defines the brand's country.
  - `contact` object: Defines contact details.
    - `email` string: Defines the brand's email address. It must be a valid email format.
    - `phone` string, nullable: Defines the brand's phone number.

## Response `200`

Returns the details about the updated brand configuration.

- ManagementProjectsBrandingUpdateResponseBody: Response brand schema.
  - `id` string, required: Unique identifier of the brand configuration.
  - `brand` object, required: Defines basic brand details.
    - `name` string, required: Defines brand name.
    - `privacy_policy_url` string, nullable, required: Defines the URL to the brand's privacy policy. It must be a valid URL format.
    - `terms_of_use_url` string, nullable, required: Defines the URL to the brand's terms of use. It must be a valid URL format.
    - `permission_reminder` string, required: Defines the message that is displayed to customers who opted in an email newsletter.
    - `website_url` string, nullable, required: Defines the URL to the brand's website. It must be a valid URL format.
  - `address` object, required: Defines the address details.
    - `street` string, required: Defines the brand's street.
    - `city` string, required: Defines the brand's city.
    - `postal` string, nullable, required: Defines the brand's postal code.
    - `state` string, required: Defines the brand's state or similar administrative area.
    - `country` string, required: Defines the brand's country.
  - `contact` object, required: Defines contact details.
    - `email` string, required: Defines the brand's email address. It must be a valid email format.
    - `phone` string, nullable, required: Defines the brand's phone number.

## Other responses

- `400`: Returns an error if the payload includes incorrect details.
- `401`: Returns an error if an invalid token was provided.
- `402`: Returns an error if the current plan does not include the Management API feature.
- `404`: Returns an error when a resource could not be found.

---

[API](https://skmtc.dev/voucherifyio/apis/voucherify-api-async-actions.md) - [All operations](https://skmtc.dev/voucherifyio/apis/voucherify-api-async-actions/llms.txt) - [OpenAPI document](https://skmtc.dev/voucherifyio/apis/voucherify-api-async-actions/revisions/4982266e0494?raw)