---
title: "Attach approved creator brand-kit references"
method: POST
path: "/brand-kits/references"
---

# Attach approved creator brand-kit references

`POST /brand-kits/references`

## Request

- Base URL: `https://api.bamf.ai/v1`
- URL: `https://api.bamf.ai/v1/brand-kits/references`
- Auth: HTTP bearer

Idempotently appends or explicitly replaces HTTPS style references on a creator-scoped brand pack. Pairing or API authentication never grants creator access; the caller must already have media:write for the requested creator.

## Parameters

- `#/components/parameters/IdempotencyKey` (unresolved $ref)

## Request body

- object
  - `creator_id` string, required
  - `brand_pack_id` string
  - `pack_type` 'personal' | 'image_quote' | 'infographic' | 'carousel'
  - `mode` 'append' | 'replace'
  - `asset_role` 'logo' | 'style_reference' | 'template_reference' | 'texture' | 'color_reference'
  - `reference_urls` string[]
  - `inline_reference_data_urls` string[]
  - `name` string
  - `description` string, nullable
  - `tags` string[]
  - `palette` string[]
  - `fonts` string[]
  - `visual_style_prompt` string, nullable
  - `brand_rules` string, nullable
  - `negative_prompt` string, nullable
  - `notes` string, nullable

## Response `200`

Updated brand pack and mutation receipt

- GenericDataResponse
  - `data` unknown

---

[API](https://skmtc.dev/bamf/apis/bamf-developer-platform-api.md) · [All operations](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/revisions/a390dd3294bd?raw)