Update Flag Config

# Simple enable
curl -X PUT https://nest.feather.mupeni.dev/v1/projects/proj_01hx.../environments/env_01hx.../flags/new-checkout \
  -H "Authorization: Bearer <server_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "version": 1,
    "enabled": true,
    "defaultValue": false,
    "rules": []
  }'

# With targeting rule
curl -X PUT https://nest.feather.mupeni.dev/v1/projects/proj_01hx.../environments/env_01hx.../flags/new-checkout \
  -H "Authorization: Bearer <server_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "version": 2,
    "enabled": true,
    "defaultValue": false,
    "rules": [
      {
        "id": "rule-beta",
        "name": "Beta users",
        "enabled": true,
        "conditionOperator": "AND",
        "conditions": [
          { "attribute": "plan", "operator": "equals", "value": "beta" }
        ],
        "value": true
      }
    ]
  }'

{
  "id": "fv_02hx...",
  "flagId": "flag_01hx...",
  "environmentId": "env_01hx...",
  "version": 2,
  "config": {
    "version": 2,
    "enabled": true,
    "defaultValue": false,
    "rules": []
  },
  "createdAt": "2024-04-02T08:00:00.000Z"
}

{
  "error": {
    "code": "PROTECTED_ENVIRONMENT",
    "message": "This environment requires a change proposal. Use POST /proposals instead."
  }
}

{
  "error": {
    "code": "VERSION_CONFLICT",
    "message": "Expected version 3, got 2. Fetch the latest version and retry."
  }
}

{
  "id": "fv_02hx...",
  "version": 2,
  "syncWarning": "Edge cache sync failed: timeout. Config saved but evaluations may serve stale data."
}

PUT

projects

{projectId}

environments

{envId}

flags

{flagKey}

# Simple enable
curl -X PUT https://nest.feather.mupeni.dev/v1/projects/proj_01hx.../environments/env_01hx.../flags/new-checkout \
  -H "Authorization: Bearer <server_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "version": 1,
    "enabled": true,
    "defaultValue": false,
    "rules": []
  }'

# With targeting rule
curl -X PUT https://nest.feather.mupeni.dev/v1/projects/proj_01hx.../environments/env_01hx.../flags/new-checkout \
  -H "Authorization: Bearer <server_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "version": 2,
    "enabled": true,
    "defaultValue": false,
    "rules": [
      {
        "id": "rule-beta",
        "name": "Beta users",
        "enabled": true,
        "conditionOperator": "AND",
        "conditions": [
          { "attribute": "plan", "operator": "equals", "value": "beta" }
        ],
        "value": true
      }
    ]
  }'

{
  "id": "fv_02hx...",
  "flagId": "flag_01hx...",
  "environmentId": "env_01hx...",
  "version": 2,
  "config": {
    "version": 2,
    "enabled": true,
    "defaultValue": false,
    "rules": []
  },
  "createdAt": "2024-04-02T08:00:00.000Z"
}

{
  "error": {
    "code": "PROTECTED_ENVIRONMENT",
    "message": "This environment requires a change proposal. Use POST /proposals instead."
  }
}

{
  "error": {
    "code": "VERSION_CONFLICT",
    "message": "Expected version 3, got 2. Fetch the latest version and retry."
  }
}

{
  "id": "fv_02hx...",
  "version": 2,
  "syncWarning": "Edge cache sync failed: timeout. Config saved but evaluations may serve stale data."
}

This endpoint appends a new version — it never mutates existing rows. The new version becomes the active config immediately and the edge cache is updated. If the environment is protected, this endpoint returns 403. Use Create Proposal instead.

Path parameters

string

required

string

required

string

required

The flag’s key.

Body

number

required

Must equal the current latest version plus one. If the flag has no existing version in this environment, send 1. If the value does not match, the server returns 409 VERSION_CONFLICT — fetch the latest version and retry.

boolean

required

Master toggle. false short-circuits all rules and returns defaultValue.

boolean | string | number

required

Returned when no rule matches. Must match the flag’s type.

Rule[]

required

Ordered list of targeting rules. See Flag Config for the full rule schema. Pass an empty array for a simple on/off flag.

Variant[]

Named value definitions for string or number flags.

Using regex or geo_country operators, or setting rolloutPercentage on a rule, requires a Pro or Enterprise plan.

# Simple enable
curl -X PUT https://nest.feather.mupeni.dev/v1/projects/proj_01hx.../environments/env_01hx.../flags/new-checkout \
  -H "Authorization: Bearer <server_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "version": 1,
    "enabled": true,
    "defaultValue": false,
    "rules": []
  }'

# With targeting rule
curl -X PUT https://nest.feather.mupeni.dev/v1/projects/proj_01hx.../environments/env_01hx.../flags/new-checkout \
  -H "Authorization: Bearer <server_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "version": 2,
    "enabled": true,
    "defaultValue": false,
    "rules": [
      {
        "id": "rule-beta",
        "name": "Beta users",
        "enabled": true,
        "conditionOperator": "AND",
        "conditions": [
          { "attribute": "plan", "operator": "equals", "value": "beta" }
        ],
        "value": true
      }
    ]
  }'

{
  "id": "fv_02hx...",
  "flagId": "flag_01hx...",
  "environmentId": "env_01hx...",
  "version": 2,
  "config": {
    "version": 2,
    "enabled": true,
    "defaultValue": false,
    "rules": []
  },
  "createdAt": "2024-04-02T08:00:00.000Z"
}

{
  "error": {
    "code": "PROTECTED_ENVIRONMENT",
    "message": "This environment requires a change proposal. Use POST /proposals instead."
  }
}

{
  "error": {
    "code": "VERSION_CONFLICT",
    "message": "Expected version 3, got 2. Fetch the latest version and retry."
  }
}

{
  "id": "fv_02hx...",
  "version": 2,
  "syncWarning": "Edge cache sync failed: timeout. Config saved but evaluations may serve stale data."
}

Update Flag List API Keys

Getting Started

Concepts

Management API

Delivery API

Path parameters

Body

​Path parameters

​Body

Path parameters

Body