/v1/workspaces/{workspace_id}/settings/{setting_id}AuthGet a setting
The setting with its value and targeting in every environment, and what depends on it (`dependents`).
Path parameters
setting_id*string · uuidId of the setting.
workspace_id*string · uuidId of the workspace.
Response · 200 The setting.
id*string · uuidThe setting's id.
workspace_id*string · uuidThe workspace that owns it.
project_id*string · uuidThe project.
config_id*string · uuidThe config it belongs to.
key*stringThe key SDKs read it by; unique in the config, case-sensitive.
Example: "new_checkout"
name*stringDisplay name.
Example: "New checkout"
description*stringFree-text description (may be empty).
Example: ""
hint*stringA short hint shown next to the flag in the console (may be empty).
Example: ""
type*object`boolean` is a feature flag; the others are typed settings. Cannot change.
Example: "boolean"
tags*arrayFree-form tags.
Example: ["checkout"]
lifecycle*object`temporary` (a release flag you plan to remove) or `permanent` (an ops switch or a setting).
Example: "temporary"
owner_id*string · uuidThe platform user who owns the flag (a workspace member), or null.
seed*stringThe value percentage splits hash with: the key at creation (or the ConfigCat key on import). It never changes, so renaming a key does not move users between variations.
Example: "new_checkout"
ordinal*integerSort position in the config (ascending).
Example: 0
created_by*stringWho created it (user or API key id).
created_at*string · date-timeWhen it was created.
updated_at*string · date-timeWhen its metadata last changed.
values*arrayIts value and targeting in every environment, in environment order.
dependents*objectWhat depends on this setting: check before deleting or renaming it.
Example
Request
GET https://api.flags.productcraft.co/v1/workspaces/{workspace_id}/settings/{setting_id}
Authorization: Bearer YOUR_TOKENResponse
{
"id": "00000000-0000-0000-0000-000000000000",
"workspace_id": "00000000-0000-0000-0000-000000000000",
"project_id": "00000000-0000-0000-0000-000000000000",
"config_id": "00000000-0000-0000-0000-000000000000",
"key": "new_checkout",
"name": "New checkout",
"description": "",
"hint": "",
"type": "boolean",
"tags": [
"checkout"
],
"lifecycle": "temporary",
"owner_id": "00000000-0000-0000-0000-000000000000",
"seed": "new_checkout",
"ordinal": 0,
"created_by": "string",
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"values": [
{
"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"
}
],
"dependents": {}
}