Create a new custom rule set version

post

https://{hostname}/delivery-manager/v1/workspaces/{workspaceName}/environments/{environmentName}/rule-sets/{ruleSetName}/versions

This operation creates a new version of a custom rule set. You can modify a version until it's activated. Once you activate a version, you need to create a new one to edit its settings. Custom rules offer detailed control and conditional logic to process requests to your application or service, overriding default settings when specified. Use the environment version's ruleSetOrder array to manage how rule sets execute.

Path Params

workspaceName

string

required

Name of the workspace that unifies all resources for your application or service. You can rename the workspace with a separate operation after you initially create the resource.

environmentName

string

required

Name of the environment, unique within a workspace. You can't modify it after you initially create it with a POST request.

ruleSetName

string

required

A unique name for the rule set.

Query Params

reuseVersions

boolean

Defaults to true

Whether to re-use an existing resource version. The default true value checks for content parity and only creates a new version if the request content doesn't match an existing one. When false, creates a new version regardless of the request content.

accountSwitchKey

string

For customers who manage more than one account, this runs the operation from another account. The Identity and Access Management API provides a list of available account switch keys.

Body Params

rules

array of objects

required

This object flexibly expresses the configuration settings for rules. Its specific structure and set of fields depend on the rule type and your application's requirements. It defines conditions, actions, and other relevant options needed to properly configure the rule for your use case.

rules*

Response

201The response shows the new custom rule set version, which you can GET at the URL in the Location header.