Skip to main content
A branding is a visual identity documents are rendered with. Brandings are designed in the Fidly interface; the API reads them (label, is_default, without the visual assets) and designates which one applies. Nothing else: no creation, no deletion, no change to the content.
The permission on brandings is not granted by default to existing clients — ask for it if /brandings returns 403.

Choosing the default

A company always has exactly one default branding. is_default: true promotes a branding and demotes the previous one; is_default: false on the current default is refused (422 default_branding_required) — promote another branding instead. Re-sending the value a branding already has does nothing.