List Brand Kit Images
List images attached to a brand kit (ENG-2585).
Returns one row per attached image across logos + design assets so
integrators can reconcile state with addBrandKitImage /
removeBrandKitImage and avoid duplicate uploads when migrating
legacy kits.
Returns 404 not_found if the brand kit does not exist, has been
deleted, or the caller lacks team access — the three cases are
collapsed so the endpoint does not leak existence of brand kits in
other teams.
Authorizations
API key from Settings > Developer > REST API
Headers
Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.
2026-04-12, 2026-05-01 "2026-05-01"
Path Parameters
Prefixed bk_ wire ID (Crockford base32 body) — the canonical, recommended form. For back-compat, a bare UUID string is also accepted in both path parameters and JSON request bodies (older integrations that stored raw UUIDs keep working). Both are permanent, supported inputs.
^bk_[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$"bk_01HT9WK8N3M2J4A5Z6P7Q8R9TV"
Response
Successful Response
Brand-kit images list response (ENG-2585).
Returns the full list — brand-kit image counts are small (typical kit
has <20 images) so cursor pagination would be over-kill in v1. If a
customer hits a real ceiling we can add a cursor without a breaking
change. total / returned are carried anyway so the envelope
matches the uniform list contract and explicitly says "complete".
All images attached to the brand kit, logos first then design assets, in insertion order.
Number of images returned (always len(data)).
True total image count for this brand kit. Always equals returned — this list is complete.