---
title: "Create a draft layout from validated HTML or a brand-seeded default."
method: POST
path: "/v1/workspaces/{workspaceId}/managed-layouts"
---

# Create a draft layout from validated HTML or a brand-seeded default.

`POST /v1/workspaces/{workspaceId}/managed-layouts`

## Request

- Base URL: `https://api.bangermail.com`
- URL: `https://api.bangermail.com/v1/workspaces/{workspaceId}/managed-layouts`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `name` string, required
  - `html` string: Must contain exactly one content slot.
  - `source_locale` string
  - `source_messages` object
  - `translations` object

## Response `200`

Successful response.

- object
  - `data` object, required
    - `id` string, uuid, required
    - `name` string, required
    - `version` integer, required
    - `draft_revision_id` string, uuid, nullable, required
    - `published_revision_id` string, uuid, nullable, required
    - `published_publication_id` string, uuid, nullable, required
    - `replayed` boolean, required

## Other responses

- `201`: Draft layout.

---

[API](https://skmtc.dev/bangermail/apis/banger-api.md) · [All operations](https://skmtc.dev/bangermail/apis/banger-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bangermail/apis/banger-api/revisions/a149909267f9?raw)