---
title: "Create a new site"
method: POST
path: "/authoring/v1/sites"
tags: ["Authoring sites"]
---

# Create a new site

`POST /authoring/v1/sites`

Use this endpoint to create a new site.

The new site can either be an initial draft site which has no associated ready version or
it can be a draft of an existing ready site.

The body of the request should contain the metadata for the new site.
This metadata should include the site 'name', 'linkedDocId' is optional, 'id' is optional.
If 'linkedDocId' is provided, then the site created will be a draft of the ready site specified in 'linkedDocId'.
If 'linkedDocId' is not provided, then the site created will be an initial draft site i.e no ready version exists yet.
If ID is provided, and a draft of the default site is being created it must start with default.
'linkedDocId' must be set to 'default'.
<br />User roles: admin, manager, editor

## Query parameters

- `copySourceSiteId` string

## Request body

- object — Create Site Metadata
  - `id` string — The ID of the site. If creating a draft of the default site the id must start with default.
  - `linkedDocId` string — The linkedDocId for draft sites. This is an optional field, if provided specify the ID of the ready site to create a draft of.
  - `name` string — The name of the site. This is a required field.
  - `status` string — The status of the site metadata (i.e. draft)
  - `routingMode` string — The is routingMode 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 `201`

succcess.

- object — Site Metadata
  - `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`
  - `lastModified` string — The last modified date of this site metadata in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ. This field is read only.
  - `lastModifierId` string — This is the user id of the user that modified the site metadata. This field is read only
  - `created` string — The creation date of this site metadata in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ. This field is read only
  - `creatorId` string — This is the user id of the user that created the site metadata. This field is read only.
  - `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
- `409` — Conflict
- `429` — Too Many Requests, the server has reached a limit, the request must be sent again at a later time.
- `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)