Flags API reference

Flags API · Settings

get/v1/workspaces/{workspace_id}/settings/{setting_id}/values/{environment_id}Auth

Get a value

The setting's value and targeting in one environment, with its `version`.

Path parameters

setting_id*string · uuid

Id of the setting.

environment_id*string · uuid

Id of an environment of the same project.

workspace_id*string · uuid

Id of the workspace.

Response · 200 The value.

setting_id*string · uuid

The setting.

environment_id*string · uuid

The environment.

environment_key*string

The environment's key.

Example: "production"

value*object

Served when no rule and no split decides (and to everyone when there are none).

Example: false

rules*array

Targeting rules, first match wins (at most 50). Each rule has `conditions` and exactly one of `serve` (a value) or `percentages` (a split).

percentages*array

Flag-level split after the rules (null for none).

percentage_attribute*string

The user attribute the splits hash; null means `identifier`.

Example: null

version*integer

Send it back with the next write; a stale one answers 409 `VERSION_CONFLICT`.

Example: 3

updated_by*object

Who wrote the value last.

updated_at*string · date-time

When the value last changed.

Example

Request

GET https://api.flags.productcraft.co/v1/workspaces/{workspace_id}/settings/{setting_id}/values/{environment_id}
Authorization: Bearer YOUR_TOKEN

Response

{
  "setting_id": "00000000-0000-0000-0000-000000000000",
  "environment_id": "00000000-0000-0000-0000-000000000000",
  "environment_key": "production",
  "value": false,
  "rules": [
    {}
  ],
  "percentages": [
    {
      "percentage": 10,
      "value": true
    }
  ],
  "percentage_attribute": null,
  "version": 3,
  "updated_by": {},
  "updated_at": "2026-01-01T00:00:00.000Z"
}