---
title: "Update workspace identity: name, industry and subIndustry (values from the dashboard's industry list; a new industry without a subIndustry clears the old one), productDescription, authors (EEAT bylines used in article JSON-LD), styleReferenceUrls (articles whose writing style the writer imitates), brandAliases (other spellings and short forms of the brand; pages using them count as brand mentions) and brandExclusions (same-name companies or products whose pages are skipped). Every array REPLACES the stored list — call get_brand first and send the full updated list. Saving a name change runs the brand-mention search once a day at most. websiteUrl is immutable and cannot be changed."
method: POST
path: "/api/v1/brand"
---

# Update workspace identity: name, industry and subIndustry (values from the dashboard's industry list; a new industry without a subIndustry clears the old one), productDescription, authors (EEAT bylines used in article JSON-LD), styleReferenceUrls (articles whose writing style the writer imitates), brandAliases (other spellings and short forms of the brand; pages using them count as brand mentions) and brandExclusions (same-name companies or products whose pages are skipped). Every array REPLACES the stored list — call get_brand first and send the full updated list. Saving a name change runs the brand-mention search once a day at most. websiteUrl is immutable and cannot be changed.

`POST /api/v1/brand`

## Request

- Base URL: `https://api.rctrl.com`
- URL: `https://api.rctrl.com/api/v1/brand`
- Auth: HTTP bearer

Requires the `write:content` scope.

## Request body

- object
  - `name` string: Brand name
  - `industry` string: Your industry, from the dashboard's list
  - `subIndustry` string: Specialty within the industry, from the same list
  - `productDescription` string: What you sell, in a sentence or two
  - `authors` object[]: Article bylines. Replaces the stored list.
    - `name` string, required: Author's full name
    - `bio` string: Short author bio
    - `linkedinUrl` string: Person sameAs URL for article JSON-LD
  - `styleReferenceUrls` string[]: Articles whose writing style your articles follow. Replaces the stored list.
  - `brandAliases` string[]: Other spellings and short forms of your brand name. Replaces the stored list.
  - `brandExclusions` string[]: Same-name companies or products to leave out of brand mentions. Replaces the stored list.

## Response `200`

Success; the payload is wrapped in a data envelope

- object
  - `data` unknown

## Other responses

- `400`: Bad input
- `401`: Missing or invalid API key
- `403`: API key lacks the required scope
- `404`: Not found in this workspace
- `429`: Rate limited; the body includes a retryAfterMs hint

---

[API](https://skmtc.dev/rctrl/apis/rankcontrol-api.md) · [All operations](https://skmtc.dev/rctrl/apis/rankcontrol-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rctrl/apis/rankcontrol-api/revisions/98ecd236394a?raw)