Skip to main content
POST
/
console
/
v1
/
layers
Create a Layer
curl --request POST \
  --url https://statsigapi.net/console/v1/layers \
  --header 'Content-Type: application/json' \
  --header 'STATSIG-API-KEY: <api-key>' \
  --data '
{
  "name": "<string>",
  "idType": "<string>",
  "description": "<string>",
  "targetApps": "<string>",
  "team": "<string>"
}
'
{
  "message": "Layer created successfully.",
  "data": {
    "id": "the_best_layer",
    "description": "helpful summary of what this layer does",
    "idType": "userID",
    "lastModifierID": "4dcQUIpS8PHObBGD7HJwOx",
    "lastModifiedTime": 1720733945538,
    "lastModifierName": "CONSOLE API",
    "lastModifierEmail": null,
    "creatorID": "4dcQUIpS8PHObBGD7HJwOx",
    "createdTime": 1720733942515,
    "creatorName": "CONSOLE API",
    "creatorEmail": null,
    "targetApps": [
      "Android"
    ],
    "holdoutIDs": [
      "global_holdout",
      "test_holdout"
    ],
    "tags": [],
    "team": "Console Team",
    "isImplicitLayer": false,
    "parameters": []
  }
}

Authorizations

​
STATSIG-API-KEY
string
header
required

Headers

​
x-respect-review-settings
string

Optional header to respect review settings for mutation endpoints.

Body

application/json
​
name
string
required

The unique name of the layer, formatted as an ID (e.g., "A Layer" becomes "a_layer").

Required string length: 3 - 100
​
idType
string
required

The type of ID used for this layer, essential for validation in services.

​
description
string

A helpful description of what this layer does, providing context for its purpose.

Maximum string length: 1000
​
targetApps

List of target applications that this layer is associated with.

​
team
string

Optional identifier for the team responsible for this layer.

Response

Create Layer Response

​
message
string
required

A simple string explaining the result of the operation.

​
data
object
required

A single result.