---
title: "Create layer"
method: POST
path: "/api/v2/projects/{projectKey}/layers"
tags: ["Layers"]
---

# Create layer

`POST /api/v2/projects/{projectKey}/layers`

Create a layer. Experiments running in the same layer are granted mutually-exclusive traffic.

## Path parameters

- `projectKey` string, string, required — The project key

## Request body

- LayerPost
  - `key` string, required — Unique identifier for the layer
  - `name` string, required — Layer name
  - `description` string, required — The checkout flow for the application

## Response `201`

Layer response

- LayerRep
  - `key` string, required — The key of the layer
  - `name` string, required — The name of the layer
  - `description` string, required — The description of the layer
  - `createdAt` integer, required
  - `randomizationUnit` string — The unit of randomization for the layer
  - `environments` object — The layer configurations for each requested environment

## Other responses

- `400` — Invalid request
- `403` — Forbidden
- `404` — Invalid resource identifier
- `429` — Rate limited

---

[API](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api.md) · [All operations](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/launchdarkly/launchdarkly-rest-api/revisions/69c5c9aafe78/schema)