Update environment

PATCH
/api/v2/projects/:projectKey/environments/:environmentKey

Update an environment. Updating an environment uses a JSON patch representation of the desired changes. To learn more, read Updates.

To update fields in the environment object that are arrays, set the path to the name of the field and then append /<array index>. Using /0 appends to the beginning of the array.

Approval settings

This request only returns the approvalSettings key if the flag approvals feature is enabled.

Only the canReviewOwnRequest, canApplyDeclinedChanges, minNumApprovals, required and requiredApprovalTagsfields are editable.

If you try to patch the environment by setting both required and requiredApprovalTags, the request fails and an error appears. You can specify either required approvals for all flags in an environment or those with specific tags, but not both.

Path parameters

projectKeystringRequired

The project key

environmentKeystringRequired

The environment key

Request

This endpoint expects a list of objects.
list of objects

Response

Environment response

_idstring

The ID for the environment. Use this as the client-side ID for authorization in some client-side SDKs, and to associate LaunchDarkly environments with CDN integrations in edge SDKs.

keystring

A project-unique key for the new environment

namestring

A human-friendly name for the new environment

apiKeystring

The SDK key for the environment. Use this for authorization in server-side SDKs.

mobileKeystring

The mobile key for the environment. Use this for authorization in mobile SDKs.

colorstring

The color used to indicate this environment in the UI

defaultTtlinteger

The default time (in minutes) that the PHP SDK can cache feature flag rules locally

secureModeboolean

Ensures that one end user of the client-side SDK cannot inspect the variations for another end user

defaultTrackEventsboolean

Enables tracking detailed information for new flags by default

requireCommentsboolean

Whether members who modify flags and segments through the LaunchDarkly user interface are required to add a comment

confirmChangesboolean

Whether members who modify flags and segments through the LaunchDarkly user interface are required to confirm those changes

tagslist of strings

A list of tags for this environment

criticalboolean

Whether the environment is critical

approvalSettingsobjectOptional

Details on the approval settings for this environment

resourceApprovalSettingsmap from strings to objectsOptional

Details on the approval settings for this environment for each resource kind

Errors

Built with