v5

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-02-283466592.5 MB

Projects

Create project

Create a new project with the given key and name. Project keys must be unique within an account.

post/api/v2/projects

Request body

namestring required

A human-friendly name for the project.

keystring required

A unique key used to reference the project in your code.

includeInSnippetByDefaultboolean

Whether or not flags created in this project are made available to the client-side JavaScript SDK by default.

tagsstring[]

Tags for the project

Example request

{
  "name": "My Project",
  "key": "project-key-123abc",
  "includeInSnippetByDefault": true,
  "defaultClientSideAvailability": {
    "usingEnvironmentId": true,
    "usingMobileKey": true
  },
  "tags": [
    "ops"
  ],
  "environments": [
    {
      "name": "My Environment",
      "key": "environment-key-123abc",
      "color": "F5A623",
      "defaultTtl": 5,
      "secureMode": true,
      "tags": [
        "ops"
      ],
      "critical": true
    }
  ],
  "namingConvention": {
    "case": "kebabCase",
    "prefix": "enable-"
  }
}

Response

Project response

_linksobject required

The location and content type of related resources

_idstring required

The ID of this project

keystring required

The key of this project

includeInSnippetByDefaultboolean required

Whether or not flags created in this project are made available to the client-side JavaScript SDK by default

namestring required

A human-friendly name for the project

tagsstring[] required

A list of tags for the project

defaultReleasePipelineKeystring

The key of the default release pipeline for this project

Example response

{
  "_links": {
    "environments": {
      "href": "/api/v2/projects/my-project/environments",
      "type": "application/json"
    },
    "self": {
      "href": "/api/v2/projects/my-project",
      "type": "application/json"
    }
  },
  "_id": "57be1db38b75bf0772d11383",
  "key": "project-key-123abc",
  "includeInSnippetByDefault": true,
  "name": "My Project",
  "_access": {
    "denied": [
      {
        "reason": {
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "actions": [
            "*"
          ],
          "effect": "allow"
        }
      }
    ],
    "allowed": [
      {
        "reason": {
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "actions": [
            "*"
          ],
          "effect": "allow"
        }
      }
    ]
  },
  "tags": [
    "ops"
  ],
  "environments": [
    {
      "_links": {
        "self": {
          "href": "/api/v2/projects/my-project/environments/my-environment",
          "type": "application/json"
        }
      },
      "_id": "57be1db38b75bf0772d11384",
      "key": "environment-key-123abc",
      "name": "My Environment",
      "apiKey": "sdk-xxx",
      "mobileKey": "mob-xxx",
      "color": "F5A623",
      "defaultTtl": 5,
      "secureMode": true,
      "_access": {
        "denied": [
          {
            "reason": {
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "actions": [
                "*"
              ],
              "effect": "allow"
            }
          }
        ],
        "allowed": [
          {
            "reason": {
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "actions": [
                "*"
              ],
              "effect": "allow"
            }
          }
        ]
      },
      "requireComments": true,
      "confirmChanges": true,
      "tags": [
        "ops"
      ],
      "approvalSettings": {
        "required": true,
        "minNumApprovals": 1,
        "canApplyDeclinedChanges": true,
        "autoApplyApprovedChanges": true,
        "serviceKind": "launchdarkly",
        "serviceConfig": {},
        "requiredApprovalTags": [
          "require-approval"
        ],
        "serviceKindConfigurationId": "1ef45a85-218f-4428-a8b2-a97e5f56c258"
      },
      "critical": true
    }
  ]
}