v5

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-07111022.9 KB

Add or update a feature control definition

Creates a new feature control or updates the definition of an existing one. Immutable fields (name, type, initialValue) cannot be updated.

post/api/feature-control

Headers

x-cdp-request-idstring

A unique identifier for the request, used for tracing.

Request body

namestring required
type'list-string' | 'list-number' | 'boolean' | 'date' | 'string' | 'number' required
initialValueobject required

Mapping of environment to initial value. Must contain 'default' or all of 'dev', 'test', 'ext-test', 'perf-test', 'prod'.

scopesstring[] required
displayNamestring required
descriptionstring required
ownerstring required
expiryDatestring date-time required
createdBystring required
roleRequiredobject

Mapping of list of required role to update control value per environment. Can contain 'default' plus any of 'local', 'dev', 'test', 'ext-test', 'perf-test', 'prod'.

environmentsstring[]

Optional list of environments this feature control applies to.

Response

Accepted - Feature control created or updated.