---
title: "Update site"
method: PUT
path: "/api/v1/sites/{uuid}"
tags: ["Sites"]
---

# Update site

`PUT /api/v1/sites/{uuid}`

## Request

- Base URL: `https://botsee.io`
- URL: `https://botsee.io/api/v1/sites/{uuid}`
- Auth: HTTP bearer

Updates a site's editable metadata: product_name, value_proposition, and aliases. All fields are optional; omitted fields are left unchanged and explicit null clears a field. Non-string, non-null values return 400 validation_error. The aliases field is a comma-separated list of alternate brand names BotSee uses to recognize the brand in AI answers. created_via, billing_status, domain, and visibility cannot be changed here. PATCH is accepted as an alias for PUT.

## Path parameters

- `uuid` string, required

## Request body

- object
  - `aliases` string, nullable: Comma-separated alternate brand names (e.g. 'Acme, Acme Corp')
  - `product_name` string, nullable: Product name
  - `value_proposition` string, nullable: Value proposition

## Response `200`

Successful response.

- object
  - `site` Site
    - `aliases` string, nullable
    - `created_at` string, date-time
    - `customer_type_count` integer
    - `customer_types` object[]
      - `name` string
      - `persona_count` integer
      - `uuid` string
    - `domain` string
    - `product_name` string, nullable
    - `status` string
    - `uuid` string
    - `value_proposition` string, nullable

## Other responses

- `401`: Missing, invalid, or revoked API key.
- `403`: Authenticated but lacks permission (e.g. botsee_disabled).
- `404`: The requested resource does not exist or is not accessible.
- `422`: Request body or parameters failed validation.
- `429`: Too many requests. Wait and retry per Retry-After header.

---

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