---
title: "Create or replace the brand kit"
method: PUT
path: "/org/brand-kit"
tags: ["Brand Kit"]
---

# Create or replace the brand kit

`PUT /org/brand-kit`

## Request

- Base URL: `https://apiv2.senso.ai/api/v1`
- URL: `https://apiv2.senso.ai/api/v1/org/brand-kit`
- Auth: API key in header `X-API-Key`

Creates or fully replaces the organization's brand kit guidelines: the stored document becomes exactly the `guidelines` object you send, so any field you omit is removed. `guidelines` is a closed object — unknown fields are rejected with `400`, and no field may be `null`. An empty object (`{}`) is accepted. Requires the GEO product.

## Request body

- UpsertBrandKitRequest: A full-replacement write of the brand kit guidelines.
  - `guidelines` BrandKitGuidelines, required: The brand guidelines document. A closed object — the server rejects unknown fields with `400`. Every field is optional, and no field may be `null`.
    - `brand_name` string: The company name.
    - `brand_domain` string: The company's website URL.
    - `brand_description` string: What the company is, the problem it addresses, its approach, what users get, and why customers trust it.
    - `voice_and_tone` string: The communication style generated content should follow — language patterns, what to avoid, dos and don'ts.
    - `author_persona` string: The ideal content author, described as a specific persona.
    - `global_writing_rules` string[]: Directional writing rules for the AI writer (e.g. "prefer concrete examples", "avoid superlatives").

## Response `200`

The saved brand kit.

- BrandKitResponse: The organization's brand kit.
  - `brand_kit_id` string, uuid, required
  - `org_id` string, uuid, required
  - `guidelines` BrandKitGuidelines, required: The brand guidelines document. A closed object — the server rejects unknown fields with `400`. Every field is optional, and no field may be `null`.
    - `brand_name` string: The company name.
    - `brand_domain` string: The company's website URL.
    - `brand_description` string: What the company is, the problem it addresses, its approach, what users get, and why customers trust it.
    - `voice_and_tone` string: The communication style generated content should follow — language patterns, what to avoid, dos and don'ts.
    - `author_persona` string: The ideal content author, described as a specific persona.
    - `global_writing_rules` string[]: Directional writing rules for the AI writer (e.g. "prefer concrete examples", "avoid superlatives").
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400`: The request was malformed — a bad path/query parameter or an invalid value.
- `401`: Missing or invalid credentials — supply a valid org API key in the `X-API-Key` header.
- `403`: The API key is authenticated but not permitted to access this resource.

---

[API](https://skmtc.dev/senso/apis/senso-org-api.md) - [All operations](https://skmtc.dev/senso/apis/senso-org-api/llms.txt) - [OpenAPI document](https://skmtc.dev/senso/apis/senso-org-api/revisions/d789b4fcbe84?raw)