> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

---
id: 443b1a43-f4d7-4f00-8ccf-25677f9ab551
---

# Layouts API guide

> Read-only access to CMS layout (global group) data via the legacy v2 API.

The layouts API provides read access to **global groups** — reusable layout regions that could be shared across CMS templates in the design manager. These are a legacy concept from the older HubSpot CMS template system.

<Warning>
  This is a legacy v2 API, which does not have a newer version available. It's recommended to use one of these modern alternatives instead:

  * **Local development:** use the [HubSpot CLI](https://developers.hubspot.com/docs/cms/tools/cli) (`hs fetch`) to pull design manager assets directly to your local filesystem.
  * **Programmatic access:** use the [CMS Source Code API](/api-reference/legacy/cms/source-code/guide) to read and write template files via API.
  * **Reusable content regions:** use [global modules](https://developers.hubspot.com/docs/cms/building-blocks/modules/global-modules) instead of legacy global groups.
</Warning>

## Endpoints

| Endpoint                                                                                   | Path                                                          |
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------- |
| [List layouts](/api-reference/legacy/cms/v2/layouts/get-Layouts)                           | `GET /content/api/v2/layouts`                                 |
| [Get layout by ID](/api-reference/legacy/cms/v2/layouts/get-LayoutBy-id)                   | `GET /content/api/v2/layouts/{layoutId}`                      |
| [Get auto-save buffer](/api-reference/legacy/cms/v2/layouts/get-LayoutBuffer)              | `GET /content/api/v2/layouts/{layoutId}/buffer`               |
| [Check buffer for changes](/api-reference/legacy/cms/v2/layouts/get-LayoutBufferedChanges) | `GET /content/api/v2/layouts/{layoutId}/has-buffered-changes` |
| [List layout versions](/api-reference/legacy/cms/v2/layouts/get-LayoutVersions)            | `GET /content/api/v2/layouts/{layoutId}/versions`             |
| [Get layout version](/api-reference/legacy/cms/v2/layouts/get-LayoutVersion)               | `GET /content/api/v2/layouts/{layoutId}/versions/{versionId}` |