HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Update Brand Logo

🚧

This endpoint is in beta and subject to change.

A beta revision header (2026-07-15.pre) is required to use our beta APIs. Klaviyo APIs in beta are not intended for use in production. See our versioning and deprecation policy for more information.

Update the brand logo with the given ID.

Rate limits:
Burst: 3/s
Steady: 60/m

Scopes:
brands:write

OpenAPI Spec

Path Params
string
required

The ID of the brand logo.

Query Params
fields[brand-logo]
array of strings
fields[brand-logo]
Allowed:
Body Params

PATCH /api/brand-logos/{id} — JSON:API field-level partial update.

Per https://jsonapi.org/format/#crud-updating-resource-attributes, only
the top-level attributes/relationships present in the request body are
replaced; missing top-level fields are preserved. A client can patch
just name without disturbing width, alt_text, the image
relationship, etc.

A present top-level field is replaced wholesale (no recursive merge
into nested structures), so sending "alt_text": null clears it.

The image relationship is optional on PATCH — omit to keep the
existing image; include with a non-null data to repoint at a
different image. A logo must have an image, so the JSON:API
"unlink" form ("image": {"data": null}) is not supported and is
treated the same as omitting the relationship (existing image
preserved).

data
object
required
Headers
string
required
Defaults to 2026-07-15.pre

API endpoint revision (format: YYYY-MM-DD[.suffix])

Responses

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/vnd.api+json