Layouts API guide - HubSpot docs

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.

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 (hs fetch) to pull design manager assets directly to your local filesystem.
Programmatic access: use the CMS Source Code API to read and write template files via API.
Reusable content regions: use global modules instead of legacy global groups.

Endpoints

Endpoint	Path
List layouts	`GET /content/api/v2/layouts`
Get layout by ID	`GET /content/api/v2/layouts/{layoutId}`
Get auto-save buffer	`GET /content/api/v2/layouts/{layoutId}/buffer`
Check buffer for changes	`GET /content/api/v2/layouts/{layoutId}/has-buffered-changes`
List layout versions	`GET /content/api/v2/layouts/{layoutId}/versions`
Get layout version	`GET /content/api/v2/layouts/{layoutId}/versions/{versionId}`

Last modified on April 2, 2026

⌘I

​Endpoints

Endpoints