---
title: "Update Brand"
method: PATCH
path: "/v1/apps/{listing_id}/brand"
tags: ["creative-apps"]
---

# Update Brand

`PATCH /v1/apps/{listing_id}/brand`

## Request

- Base URL: `https://api.theagentc.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.theagentc.io/v1/apps/{listing_id}/brand`
- Auth: HTTP bearer

Edit brand tokens by hand (the editable brand kit). Any field set here
is pinned (_locked) so a later brand refresh won't overwrite it.

## Path parameters

- `listing_id` string, uuid, required

## Request body

- AppSchemasCreativeBrandUpdate: Manual brand-kit overrides. Any field set here is pinned so a later brand refresh won't overwrite it. RGB fields are [r, g, b] 0-255.
  - `accent` integer[], nullable
  - `bg` integer[], nullable
  - `card` integer[], nullable
  - `ink` integer[], nullable
  - `warm` integer[], nullable
  - `style` string, nullable
  - `brand_line` string, nullable

## Response `200`

Successful Response

- AppListingRead
  - `id` string, uuid, required
  - `workspace_id` string, uuid, nullable, required
  - `apple_app_id` string, required
  - `bundle_id` string, nullable, required
  - `name` string, required
  - `subtitle` string, nullable, required
  - `category` string, nullable, required
  - `icon_url` string, nullable, required
  - `screenshot_urls` string[], nullable, required
  - `uploaded_screenshots` string[], nullable
  - `brand_tokens` object, nullable, required
  - `review_summary` ReviewSummary
    - `count` integer
    - `avg_rating` number, nullable
    - `mined_at` string, nullable
  - `concepts_count` integer, nullable
  - `cover_url` string, nullable
  - `unreleased` boolean
  - `status` string, required
  - `error` string, nullable, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/theagentc/apis/the-agent-c-api.md) · [All operations](https://skmtc.dev/theagentc/apis/the-agent-c-api/llms.txt) · [OpenAPI document](https://skmtc.dev/theagentc/apis/the-agent-c-api/revisions/1c9868b44584?raw)