Skip to main content

Get value

GET 
/v1/settings/:settingKeyOrId/value

This endpoint returns the value of a Feature Flag or Setting in a specified Environment identified by the SDK key passed in the X-CONFIGCAT-SDKKEY header.

The most important attributes in the response are the value, rolloutRules and percentageRules. The value represents what the clients will get when the evaluation requests of our SDKs are not matching to any of the defined Targeting or Percentage Rules, or when there are no additional rules to evaluate.

The rolloutRules and percentageRules attributes are representing the current Targeting and Percentage Rules configuration of the actual Feature Flag or Setting in an ordered collection, which means the order of the returned rules is matching to the evaluation order. You can read more about these rules here.

Request​

Path Parameters

    settingKeyOrId stringrequired

    The key or id of the Setting.

Header Parameters

    X-CONFIGCAT-SDKKEY string

    The ConfigCat SDK Key. (https://app.configcat.com/sdkkey)

Responses​

Schema

    rolloutRules

    object[]

    nullable

    The targeting rule collection.

  • Array [

    • comparisonAttribute stringnullable

    Possible values: <= 1000 characters

    The user attribute to compare.

    comparator RolloutRuleComparator

    Possible values: [isOneOf, isNotOneOf, contains, doesNotContain, semVerIsOneOf, semVerIsNotOneOf, semVerLess, semVerLessOrEquals, semVerGreater, semVerGreaterOrEquals, numberEquals, numberDoesNotEqual, numberLess, numberLessOrEquals, numberGreater, numberGreaterOrEquals, sensitiveIsOneOf, sensitiveIsNotOneOf]

    The comparison operator the evaluation process must use when it compares the given user attribute's value with the comparison value.

    comparisonValue stringnullable

    The value to compare against.

    value nullable

    The value to serve when the comparison matches. It must respect the setting type.

    segmentComparator SegmentComparator

    Possible values: [isIn, isNotIn]

    The segment comparison operator used during the evaluation process.

    segmentId uuidnullable

    The segment to compare against.

  • ]

    • rolloutPercentageItems

    object[]

    nullable

    The percentage rule collection.

  • Array [

    • percentage int64required

    The percentage value for the rule.

    value nullable

    The value to serve when the user falls in the percentage rule. It must respect the setting type.

  • ]

    • value nullable

    The value to serve. It must respect the setting type.

    setting

    object

    Metadata of a Feature Flag or Setting.

    settingId int32

    Identifier of the Feature Flag or Setting.

    key stringnullable

    Key of the Feature Flag or Setting.

    name stringnullable

    Name of the Feature Flag or Setting.

    hint stringnullable

    Description of the Feature Flag or Setting.

    settingType SettingType

    Possible values: [boolean, string, int, double]

    The type of the Feature Flag or Setting.

    order int32

    The order of the Feature Flag or Setting represented on the ConfigCat Dashboard.

    createdAt date-timenullable

    The creation time of the Feature Flag or Setting.

    creatorEmail stringnullable

    The user's email address who created the Feature Flag or Setting.

    creatorFullName stringnullable

    The user's name who created the Feature Flag or Setting.

    isWatching boolean
    updatedAt date-timenullable

    The last updated date and time when the Feature Flag or Setting.

    lastUpdaterUserEmail stringnullable

    The email of the user who last updated the Feature Flag or Setting.

    lastUpdaterUserFullName stringnullable

    The name of the user who last updated the Feature Flag or Setting.

    integrationLinks

    object[]

    nullable

    The integration links attached to the Feature Flag or Setting.

  • Array [

    • key stringnullable
    description stringnullable
    integrationLinkType IntegrationLinkType

    Possible values: [trello, jira, monday]

    url stringnullable

  • ]

    • settingTags

    object[]

    nullable

    The tags attached to the Feature Flag or Setting.

  • Array [

    • settingTagId int64
    tagId int64
    name stringnullable
    color stringnullable

  • ]

    • config

    object

    Details of the Config.

    product

    object

    Details of the Product.

    organization

    object

    Details of the Organization.

    organizationId uuid

    Identifier of the Organization.

    name stringnullable

    Name of the Organization.

    productId uuid

    Identifier of the Product.

    name stringnullable

    Name of the Product.

    description stringnullable

    Description of the Product.

    order int32

    The order of the Product represented on the ConfigCat Dashboard. Determined from an ascending sequence of integers.

    reasonRequired boolean

    Determines whether a mandatory reason must be given every time when the Feature Flags or Settings within a Product are saved.

    configId uuid

    Identifier of the Config.

    name stringnullable

    Name of the Config.

    description stringnullable

    Description of the Config.

    order int32

    The order of the Config represented on the ConfigCat Dashboard.

    migratedConfigId uuidnullable
    evaluationVersion EvaluationVersion

    Possible values: [v1, v2]

    Determines the evaluation version of a Config. Using v2 enables the new features of Config V2 (https://configcat.com/docs/advanced/config-v2).

    environment

    object

    Details of the Environment.

    product

    object

    Details of the Product.

    organization

    object

    Details of the Organization.

    organizationId uuid

    Identifier of the Organization.

    name stringnullable

    Name of the Organization.

    productId uuid

    Identifier of the Product.

    name stringnullable

    Name of the Product.

    description stringnullable

    Description of the Product.

    order int32

    The order of the Product represented on the ConfigCat Dashboard. Determined from an ascending sequence of integers.

    reasonRequired boolean

    Determines whether a mandatory reason must be given every time when the Feature Flags or Settings within a Product are saved.

    environmentId uuid

    Identifier of the Environment.

    name stringnullable

    Name of the Environment.

    color stringnullable

    The configured color of the Environment.

    description stringnullable

    Description of the Environment.

    order int32

    The order of the Environment represented on the ConfigCat Dashboard.

    reasonRequired boolean

    Determines whether a mandatory reason must be given every time when the Feature Flags or Settings in the given Environment are saved.

    featureFlagLimitations

    object

    Subscription limitations regarding Feature flag or Setting values and targeting.

    maxPercentageOptionCount int32

    Maximum number of percentage options a Feature Flag or Setting can have within a targeting rule.

    maxTargetingRuleCount int32

    Maximum number of targeting rules a Feature Flag or Setting can have.

    maxComparisonValueLength int32

    Maximum length of a text comparison value.

    maxComparisonValueListLength int32

    Maximum item count of a list comparison value.

    maxComparisonValueListItemLength int32

    Maximum length of a list comparison value's item.

    maxStringFlagValueLength int32

    Maximum length of a text Setting's value.

    maxConditionPerTargetingRuleCount int32

    Maximum number of AND conditions a Feature Flag or Setting can have within a targeting rule.

    readOnly boolean
Loading...