Environments

Creates an environment in the resolved project.

Requires at least Member. An environment past the plan's per-project environment cap is a 403 plan_limit_reached.

post/api/v1/orgs/{org}/projects/{project}/environments

Request

  • Base URL: https://api.featureflip.io
  • URL: https://api.featureflip.io/api/v1/orgs/{org}/projects/{project}/environments
  • Auth: API key in header Authorization

Path parameters

orgstring required
projectstring required

Request body

keystring nullable required
namestring nullable required
colorstring nullable
sortOrderinteger

Example request

{
  "key": "production",
  "name": "Production",
  "color": "#16A34A",
  "sortOrder": 2
}

Response

Created

idstring uuid required
keystring nullable required
namestring nullable required
colorstring nullable
sortOrderinteger required
_actionsobject

Capability hints: which operations the authenticated caller may perform on this resource, each with allowed + optional reason. Computed from the caller's role and the resource's state. Injected at runtime; safe to ignore. Present only on top-level resource responses — nested occurrences (e.g. a rule inside a targeting-config response) do not carry it.

Example response

{
  "id": "0197b69f-2b3c-7d4e-9f5a-6b7c8d9e0f1a",
  "key": "production",
  "name": "Production",
  "color": "#16A34A",
  "sortOrder": 2
}

Changes

No recorded changes to this operation across all 1 revision of this API.