Branding

Get dataroom branding

Which branding the dataroom uses (`mode`), its own stored branding (`custom`), and what visitors see (`effective`). Accepts either the internal id or the `dr_…` public id.

Switch the dataroom between the team default brand, a pinned team brand, and its own custom branding, and edit the custom branding. `{ "mode": "custom", "brand_color": "#0f172a" }` switches to custom (starting from the currently shown team brand the first time) and applies the fields. Upload custom images with PUT /v1/datarooms/{id}/branding/images/{slot}.

Upload a dataroom branding image

Upload an image for the dataroom's custom branding as the raw request body. The dataroom must be in `custom` mode; switch with PATCH /v1/datarooms/{id}/branding `{ "mode": "custom" }` first. To set an image from a public URL instead, PATCH with `{ "mode": "custom", "logo": { "source_url": "https://…" } }`.

List brands

Paginated list of the team's brands, oldest first. The default brand (`is_default: true`) applies to every link and dataroom that does not pin another brand.

Create a brand

Create a named team brand. The team's first brand becomes the default; pass `is_default: true` to make a later one the default. Images can be set here from a public `source_url`, or uploaded as raw bytes with PUT /v1/brands/{id}/images/{slot}. The number of brands is limited by plan.

Get a brand

Update a brand

Partial update: omitted fields stay as they are, null clears a field. Pass `is_default: true` to make this the team's default brand. Replaced images are deleted once nothing else uses them.

Delete a brand

Deletes the brand and its images. Links and datarooms that pinned it fall back to the team default. Deleting the default brand promotes the oldest remaining brand.

Upload a brand image

Upload a logo, banner, or link preview image as the raw request body, e.g. `curl -X PUT --data-binary @logo.png -H 'Content-Type: image/png' …`. Replaces the current image in that slot. To set an image from a public URL instead, PATCH the brand with `{ "logo": { "source_url": "https://…" } }`; to remove one, PATCH it to null.