Update approval request settings for an account

post

https://api.convert.com/api/v2/accounts/{account_id}/approval-requests/settings/{rule_code}

Updates settings of a specific approval rule for the account. Requires the
manage_approval_settings permission. The change is recorded in the account audit log.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

account_id

integer

required

ID of the account that owns the approval rule configuration.

rule_code

string

enum

required

The rule code to enable or disable (e.g., experience.activate).

Allowed:

Body Params

Updates the approval rule setting for the account.

enabled

boolean

Whether to enable (true) or disable (false) the rule.

reviewers

array of strings | null

List of user IDs allowed to approve or reject approval requests governed by this rule.

reviewers

scope

object

Scope at which a rule applies, by precedence: entity > project > account. Each level holds the
list of IDs the rule is scoped to, or null when that level is not used.

Responses

200A single approval rule setting after being enabled or disabled.

403Indicates an error occurred while processing the request. The code provides an HTTP status code, message offers a human-readable explanation or an array of validation errors, and fields (if present) specifies which input fields were problematic.

defaultIndicates an error occurred while processing the request. The code provides an HTTP status code, message offers a human-readable explanation or an array of validation errors, and fields (if present) specifies which input fields were problematic.