---
title: "Save the account's brand kit"
method: PUT
path: "/marketing/brand-kit"
tags: ["marketing"]
---

# Save the account's brand kit

`PUT /marketing/brand-kit`

## Request

- Base URL: `https://api.gogoscreen.com/api/v1`
- URL: `https://api.gogoscreen.com/api/v1/marketing/brand-kit`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Set the brand a marketing video signs with: the name on the pill, the accent colour, the default closing line, and optionally a palette, a font, a copy language and a tone. The whole kit is REPLACED, not merged — `name` and `accent` are always required, and a half left out of `palette`/`font`/`copyLanguage`/`tone` keeps what the row already had. The house copy rule is enforced here: no dashes in the name or the call to action, because the designs set them in type that has no dash. The logo is not set here: files are not part of v1.0.

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `accent` string, required: The accent colour as #rrggbb.
  - `copyLanguage` string, nullable: A language tag such as en or fr-CA.
  - `defaultCta` string, nullable: The closing line when a video does not name one. No dashes.
  - `font` string, nullable: A font id from the marketing catalogue.
  - `name` string, required: The name on the brand pill. No dashes.
  - `palette` string[], nullable: Up to four colours. The accent leads it; two entries are the band and the panel.
  - `tone` string, nullable

## Response `200`

Save the account's brand kit

- object
  - `brandKit` object, required

## Other responses

- `400`: `validation_failed` — That request is not valid. · `idempotency_key_required` — This operation needs an Idempotency-Key header: a string of up to 128 characters, unique to this request, so a retry cannot do the work twice. · `invalid_brand_kit` — That brand kit is not valid. `details.errors` names each problem.
- `401`: `unauthorized` — Authentication is required.
- `403`: `forbidden_scope` — This credential does not carry the scope this operation needs.
- `404`: `not_found` — No such resource.
- `409`: `idempotency_conflict` — That idempotency key was already used with a different request. · `idempotency_in_progress` — That idempotency key is still being processed. · `conflict` — That request conflicts with the current state.
- `413`: `payload_too_large` — That request body is too large.
- `415`: `unsupported_media_type` — That content type is not supported.
- `429`: `rate_limited` — Too many requests. Try again shortly.
- `500`: `internal_error` — Something went wrong. Try again.

---

[API](https://skmtc.dev/gogoscreen/apis/gogoscreen-api.md) · [All operations](https://skmtc.dev/gogoscreen/apis/gogoscreen-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gogoscreen/apis/gogoscreen-api/revisions/2fd812319d75?raw)