> This page is for Changelog.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.makeswift.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.makeswift.com/_mcp/server.

## Manage regions from the REST API

Three new `v1` endpoints let you create, list, and read a site's regions, including their element trees, from the REST API.

#### List Regions

```bash
GET /v1/regions?siteId={siteId}
```

Returns a site's regions for one locale, with cursor-based pagination through `limit` (1–100, default 20) and `startingAfter`.

#### Create Region

```bash
POST /v1/regions
```

Creates a region in one locale. `siteId`, `id`, `name`, and `elements` are required. The component `type` at the root of `elements` becomes the region's `type`. Returns `409` if the region already exists.

#### Get Region

```bash
GET /v1/regions/{id}?siteId={siteId}
```

Returns a single region in one locale. URL-encode the `id` if it contains reserved characters such as `/`.

* **You choose the ID**: Makeswift doesn't generate region IDs. You assign the ID (for example, `site-header`), and it must be unique within a site and locale.
* **One locale per request**: all three endpoints accept a `locale` parameter, as either a locale code like `en-US` or a site locale UUID. If you leave it out, the request uses the site's default locale. A region has to exist in the default locale before you can create it in another locale.
* **Element trees are optional**: pass `include=elements` to List Regions or Get Region to get each region's element tree. Without it, `elements` is `null`.

> **Note**
>
> The region endpoints are in beta and may change. Requests return `403` until the feature is enabled for your site or workspace. To opt in, contact support: [support@makeswift.com](mailto:support@makeswift.com).

For details, see [List Regions](/developer/api-reference/rest/regions/list-regions), [Create Region](/developer/api-reference/rest/regions/create-region), and [Get Region](/developer/api-reference/rest/regions/get-region).