Feature Revision V2

featureId

string

required

The feature this revision belongs to

baseVersion

integer

required

version

integer

required

comment

string

required

date

string<date-time>

required

status

string

required

rules

object[]

required

Unified rules array. Each rule carries its own environment scope via allEnvironments / environments.

Common fields shared by all feature rule types. Specific rule types extend this base with their own required properties (value, coverage, etc.).

Option 1
Option 2
Option 3
Option 4
Option 5

Show child attributes

createdBy

object

The user (or automated actor) responsible for an action

Show child attributes

publishedBy

object

The user (or automated actor) responsible for an action

Show child attributes

defaultValue

string

The default value at the time this revision was created

definitions

object

Show child attributes

environmentsEnabled

object

Per-environment enabled state captured in this revision (only present when kill-switch gating is enabled)

Show child attributes

envPrerequisites

object

Per-environment prerequisites captured in this revision (only present when prerequisite gating is enabled)

Show child attributes

prerequisites

object[]

Feature-level prerequisites captured in this revision. Each entry is a boolean flag ID that must evaluate to true for this flag to be active for a given user.

Show child attributes

metadata

object

Metadata fields captured in this revision (only present when metadata gating is enabled)

Show child attributes

rampActions

object[]

Pending ramp schedule actions that will be applied when this draft is published

Option 1
Option 2
Option 3

Show child attributes

autoPublishOnApproval

boolean

When true, the revision is armed to publish automatically once governance allows (immediately on approval, or on scheduledPublishAt if set).

scheduledPublishAt

string<date-time> | null

Target date for a deferred (scheduled) publish. Null/absent means publish as soon as approved.

scheduledPublishLockEdits

boolean

When true, content edits to this draft are frozen while the schedule is pending (rebasing is still allowed).

scheduledPublishLockOthers

boolean

When true, publishing other drafts of this feature is blocked while the schedule is pending.

scheduledPublishBypassApproval

boolean

When true, this schedule was armed by an admin via the bypass-approval override. It cannot be edited inline (only canceled and re-armed) and anyone with publish authority may cancel it.

scheduledPublishLastError

string

Set when a due scheduled publish keeps failing (e.g. still awaiting approval, merge conflict). Indicates the schedule is stuck and retrying.

reviews

object[]

Reviewer verdicts for the current review cycle (one entry per reviewer). Verdicts flip to their -stale variants when draft content changes after submission; the list is cleared when a new review cycle starts. Absent on revisions that predate this field.

Show child attributes

{
  "featureId": "<string>",
  "baseVersion": 123,
  "version": 123,
  "comment": "<string>",
  "date": "2023-11-07T05:31:56Z",
  "status": "<string>",
  "rules": [
    {
      "description": "<string>",
      "id": "<string>",
      "enabled": true,
      "type": "force",
      "value": "<string>",
      "allEnvironments": true,
      "condition": "<string>",
      "scheduleRules": [
        {
          "enabled": true,
          "timestamp": "2023-11-07T05:31:56Z"
        }
      ],
      "rampScheduleId": "<string>",
      "savedGroupTargeting": [
        {
          "savedGroups": [
            "<string>"
          ]
        }
      ],
      "prerequisites": [
        {
          "id": "<string>",
          "condition": "<string>"
        }
      ],
      "sparse": true,
      "environments": [
        "<string>"
      ]
    }
  ],
  "defaultValue": "<string>",
  "definitions": {},
  "environmentsEnabled": {},
  "envPrerequisites": {},
  "prerequisites": [
    {
      "id": "<string>"
    }
  ],
  "metadata": {
    "description": "<string>",
    "owner": "<string>",
    "project": "<string>",
    "tags": [
      "<string>"
    ],
    "neverStale": true,
    "valueType": "<string>",
    "jsonSchema": {
      "schema": "<string>",
      "simple": {},
      "date": "2023-11-07T05:31:56Z",
      "enabled": true
    },
    "customFields": {}
  },
  "rampActions": [
    {
      "mode": "create",
      "ruleId": "<string>",
      "name": "<string>",
      "environment": "<string>",
      "templateId": "<string>",
      "startActions": [
        {
          "patch": {
            "ruleId": "<string>",
            "coverage": 0.5,
            "condition": "<string>",
            "savedGroups": [
              {
                "ids": [
                  "<string>"
                ]
              }
            ],
            "prerequisites": [
              {
                "id": "<string>",
                "condition": "<string>"
              }
            ],
            "allEnvironments": true,
            "environments": [
              "<string>"
            ],
            "force": "<unknown>",
            "enabled": true
          },
          "targetType": "feature-rule",
          "targetId": "<string>"
        }
      ],
      "steps": [
        {
          "interval": 1,
          "actions": [
            {
              "patch": {
                "ruleId": "<string>",
                "coverage": 0.5,
                "condition": "<string>",
                "savedGroups": [
                  {
                    "ids": [
                      "<string>"
                    ]
                  }
                ],
                "prerequisites": [
                  {
                    "id": "<string>",
                    "condition": "<string>"
                  }
                ],
                "allEnvironments": true,
                "environments": [
                  "<string>"
                ],
                "force": "<unknown>",
                "enabled": true
              },
              "targetType": "feature-rule",
              "targetId": "<string>"
            }
          ],
          "approvalNotes": "<string>",
          "monitored": true,
          "holdConditions": {
            "minSampleSize": 123,
            "requiresApproval": true
          }
        }
      ],
      "endActions": [
        {
          "patch": {
            "ruleId": "<string>",
            "coverage": 0.5,
            "condition": "<string>",
            "savedGroups": [
              {
                "ids": [
                  "<string>"
                ]
              }
            ],
            "prerequisites": [
              {
                "id": "<string>",
                "condition": "<string>"
              }
            ],
            "allEnvironments": true,
            "environments": [
              "<string>"
            ],
            "force": "<unknown>",
            "enabled": true
          },
          "targetType": "feature-rule",
          "targetId": "<string>"
        }
      ],
      "startDate": "2023-11-07T05:31:56Z",
      "cutoffDate": "2023-11-07T05:31:56Z"
    }
  ],
  "autoPublishOnApproval": true,
  "scheduledPublishAt": "2023-11-07T05:31:56Z",
  "scheduledPublishLockEdits": true,
  "scheduledPublishLockOthers": true,
  "scheduledPublishBypassApproval": true,
  "scheduledPublishLastError": "<string>",
  "reviews": [
    {
      "userId": "<string>",
      "timestamp": "2023-11-07T05:31:56Z"
    }
  ]
}

Introduction

Endpoints

Models