Update Brand Kit
Updates a brand kit’s name or role assignments: color roles, main logo, heading and body fonts. Omitted fields are unchanged and null is rejected. Each role object you send replaces the existing one in full; {} clears a role and it stays cleared. Role edits return 409 until the kit is completed; shared kits return 403.
Body
Request body for PATCH /v3/brand-kits/{brand_kit_id}.
Every field is optional and omitting one leaves it unchanged. Sending a role object with no
fields inside it ({}) clears that role, and a cleared role stays cleared — nothing recomputes
over a role the caller has deliberately emptied.
Clearing is an empty object rather than null, and null is rejected outright, so each
intention has exactly one spelling. Generated clients serialise request bodies with
exclude_none and drop a null before sending, so honouring null as "clear" would clear the
role for a caller using raw HTTP and silently do nothing for a caller using our own SDK.
Response
Successful response
A single brand kit with its colors, logos and fonts.
A brand kit imported from a website is assembled in the background. While status is loading
the collections and role fields are provisional and may be empty or incomplete; the import has
finished contributing to them once status is completed. A kit whose import failed reports
error and keeps whatever was assembled before the failure. A kit can still be edited in the
HeyGen web app afterwards, so completed means the import is done, not that the kit is frozen.

