---
title: "Update metadata for a site."
method: PUT
path: "/authoring/v1/sites/{site-id}"
tags: ["Authoring sites"]
---

# Update metadata for a site.

`PUT /authoring/v1/sites/{site-id}`

Update the metadata for an existing site. A default site with ID 'default' exists out-of-the-box.

The update data must include the `rev` and `name` metadata fields.
<br />User roles: admin, manager, editor

## Path parameters

- `site-id` string, uuid, required

## Query parameters

- `forceOverride` boolean

## Headers

- `Content-Type` string, required

## Request body

- object — Updating Site Metadata
  - `id` string — The ID of the site.
  - `rev` string — The current revision of the document. This is a required field.
  - `name` string — The name of the site. This is a required field.
  - `routingMode` string — The is the routing mode for the site, values are either 'anchor' or 'path'. The property controls the URL structure that is used to address individual pages within the site. With a routing mode of 'anchor' pages are addressed by URL anchors that are relative to the site root document, for example 'https://your.host/#/products'. With a routing mode of 'path' pages are addressed by URL path fragments instead of '#' anchors, for example 'https://your.host/products'. The 'path' mode is recommended for allowing external search crawlers to index the pages as separate documents.

## Response `200`

Success, returns updated site

- object — Site Metadata update response
  - `id` string — The ID of the site.
  - `rev` string — The current revision of the document.
  - `name` string — The name of the site.
  - `classification` string — this is always `site`
  - `routingMode` string — The is the routing mode for the site, values are either 'anchor' or 'path'. The property controls the URL structure that is used to address individual pages within the site. With a routing mode of 'anchor' pages are addressed by URL anchors that are relative to the site root document, for example 'https://your.host/#/products'. With a routing mode of 'path' pages are addressed by URL path fragments instead of '#' anchors, for example 'https://your.host/products'. The 'path' mode is recommended for allowing external search crawlers to index the pages as separate documents.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `409` — Conflict
- `429` — Too Many Requests
- `default` — Unexpected error

---

[API](https://skmtc.net/goacoustic/apis/acoustic-content-api.md) · [All operations](https://skmtc.net/goacoustic/apis/acoustic-content-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goacoustic/acoustic-content-api/revisions/677305266d89/schema)