save_brand_asset
Save an image as one of the organization’s brand assets — a logo, a product image or a brand element — kept in the Creative Studio’s brand library.
A brand asset is identified by its bytes: saving the same file again under the same role returns the existing asset with status: "duplicate". A brand logo becomes the brand kit’s logo only through update_brand_kit with its creative_id (logo_primary_creative_id, logo_on_dark_creative_id or logo_icon_creative_id).
Requires a user-bound credential (OAuth login or a personal API key) whose user can manage the organization — the brand kit’s permission — and a plan that includes creative management.
Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
source | string | yes | creative:<id>, file_asset:<id>, a shared workspace image path such as /org/images/logo.png (or its memfile_ id), attachment:<id>, or an https link to the image |
role | string | yes | brand_logo, brand_product or brand_element |
name | string | no | Display name |
A source that is not an image or video within the upload limits gets error_type: "validation_error".
Returns#
json
{
"success": true,
"status": "created",
"creative_id": "ad_crtv_...",
"role": "brand_logo",
"name": "Northwind logo",
"file_asset_id": "file_asset_...",
"next": "To make a brand logo the kit's logo, pass this creative_id to update_brand_kit ...",
"source": "brand_kit"
}