---
title: "Update site"
method: POST
path: "/sites/{site_id}"
tags: ["Sites"]
---

# Update site

`POST /sites/{site_id}`

Update a site. Send only the fields you want to change.

**Permissions:** Requires write access to the site (`manage:{site_id}`).

**Returns:** A site object.

## Path parameters

- `site_id` string, required

## Request body

- object
  - `name` string — The name of the website (up to 255 characters).
  - `sharing` 'none' | 'private' | 'public' — The sharing configuration. Supported values are `none`, `private` or `public`.
  - `share_password` string — When sharing is set to `private`, you must also send a password to access the site with (up to 255 characters). **Required if sharing is private.**
  - `timezone` string — The site's reporting timezone as a [TZ database name](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) (e.g. `America/New_York`). Reporting for this site will use this timezone.
  - `multi_domain` boolean — Set to `true` to allow this site to track multiple domains.
  - `multi_domain_option` 'combined' | 'separate' — How multi-domain data is grouped: `combined` or `separate`. **Required if multi_domain is true.**

## Response `200`

Successful response

## Other responses

- `400` — Bad request. Returned for validation failures and other request problems. Send `Accept: application/json` to receive errors as JSON.
- `401` — Authentication failed — the API token is missing, malformed or invalid.

---

[API](https://skmtc.net/usefathom/apis/fathom-analytics-api.md) · [All operations](https://skmtc.net/usefathom/apis/fathom-analytics-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usefathom/fathom-analytics-api/revisions/50679caad756/schema)
