API Reference

Resolves Flag

Resolve multiple flags into variants and values. This method resolves all flags that are enabled for the given client, or a subset of them specified in the request. A flag is resolved by evaluating its rules in order, a rule matches if:

it is enabled, 2) the referred segment is active, and 3) the randomization unit is in the population indicated by the segment’s targeting criteria and population allocation. The first rule that matches will assign a variant and value to the unit. Archived flags are not included.

POST

flags:resolve

Resolves Flag

curl --request POST \
  --url https://resolver.eu.confidence.dev/v1/flags:resolve \
  --header 'Content-Type: application/json' \
  --data '
{
  "clientSecret": "<string>",
  "apply": true,
  "flags": [
    "<string>"
  ],
  "evaluationContext": {},
  "sdk": {
    "customId": "<string>",
    "version": "<string>"
  }
}
'

import requests

url = "https://resolver.eu.confidence.dev/v1/flags:resolve"

payload = {
    "clientSecret": "<string>",
    "apply": True,
    "flags": ["<string>"],
    "evaluationContext": {},
    "sdk": {
        "customId": "<string>",
        "version": "<string>"
    }
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    clientSecret: '<string>',
    apply: true,
    flags: ['<string>'],
    evaluationContext: {},
    sdk: {customId: '<string>', version: '<string>'}
  })
};

fetch('https://resolver.eu.confidence.dev/v1/flags:resolve', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://resolver.eu.confidence.dev/v1/flags:resolve",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'clientSecret' => '<string>',
    'apply' => true,
    'flags' => [
        '<string>'
    ],
    'evaluationContext' => [
        
    ],
    'sdk' => [
        'customId' => '<string>',
        'version' => '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://resolver.eu.confidence.dev/v1/flags:resolve"

	payload := strings.NewReader("{\n  \"clientSecret\": \"<string>\",\n  \"apply\": true,\n  \"flags\": [\n    \"<string>\"\n  ],\n  \"evaluationContext\": {},\n  \"sdk\": {\n    \"customId\": \"<string>\",\n    \"version\": \"<string>\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://resolver.eu.confidence.dev/v1/flags:resolve")
  .header("Content-Type", "application/json")
  .body("{\n  \"clientSecret\": \"<string>\",\n  \"apply\": true,\n  \"flags\": [\n    \"<string>\"\n  ],\n  \"evaluationContext\": {},\n  \"sdk\": {\n    \"customId\": \"<string>\",\n    \"version\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://resolver.eu.confidence.dev/v1/flags:resolve")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"clientSecret\": \"<string>\",\n  \"apply\": true,\n  \"flags\": [\n    \"<string>\"\n  ],\n  \"evaluationContext\": {},\n  \"sdk\": {\n    \"customId\": \"<string>\",\n    \"version\": \"<string>\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "resolvedFlags": [
    {
      "flag": "<string>",
      "variant": "<string>",
      "value": {},
      "flagSchema": {
        "schema": [
          {}
        ]
      },
      "reason": "RESOLVE_REASON_UNSPECIFIED",
      "shouldApply": true
    }
  ],
  "resolveToken": {},
  "resolveId": "<string>"
}

Body

application/json

clientSecret

string

required

Credentials for the client. It is used to identify the client and find the flags that are available to it.

apply

boolean

required

Determines whether the flags should be applied directly as part of the resolve, or delayed until ApplyFlag is called. A flag is typically applied when it is used, if this occurs much later than the resolve, then apply should likely be set to false.

flags

string[]

If non-empty, the specific flags are resolved, otherwise all flags available to the client will be resolved.

evaluationContext

object

An object that contains data used in the flag resolve. For example, the targeting key e.g. the id of the randomization unit, other attributes like country or version that are used for targeting.

sdk

object

Information about the SDK used to initiate the request.

Show child attributes

Response

200 - application/json

resolvedFlags

object[]

The list of all flags that could be resolved. Note: if any flag was archived it will not be included in this list.

Show child attributes

resolveToken

object

An opaque token that is used when apply is set to false in ResolveFlags. When apply is set to false, the token must be passed to ApplyFlags.

resolveId

string

Unique identifier for this particular resolve request.

⌘I

Resolves Flag

curl --request POST \
  --url https://resolver.eu.confidence.dev/v1/flags:resolve \
  --header 'Content-Type: application/json' \
  --data '
{
  "clientSecret": "<string>",
  "apply": true,
  "flags": [
    "<string>"
  ],
  "evaluationContext": {},
  "sdk": {
    "customId": "<string>",
    "version": "<string>"
  }
}
'

import requests

url = "https://resolver.eu.confidence.dev/v1/flags:resolve"

payload = {
    "clientSecret": "<string>",
    "apply": True,
    "flags": ["<string>"],
    "evaluationContext": {},
    "sdk": {
        "customId": "<string>",
        "version": "<string>"
    }
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    clientSecret: '<string>',
    apply: true,
    flags: ['<string>'],
    evaluationContext: {},
    sdk: {customId: '<string>', version: '<string>'}
  })
};

fetch('https://resolver.eu.confidence.dev/v1/flags:resolve', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://resolver.eu.confidence.dev/v1/flags:resolve",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'clientSecret' => '<string>',
    'apply' => true,
    'flags' => [
        '<string>'
    ],
    'evaluationContext' => [
        
    ],
    'sdk' => [
        'customId' => '<string>',
        'version' => '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://resolver.eu.confidence.dev/v1/flags:resolve"

	payload := strings.NewReader("{\n  \"clientSecret\": \"<string>\",\n  \"apply\": true,\n  \"flags\": [\n    \"<string>\"\n  ],\n  \"evaluationContext\": {},\n  \"sdk\": {\n    \"customId\": \"<string>\",\n    \"version\": \"<string>\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://resolver.eu.confidence.dev/v1/flags:resolve")
  .header("Content-Type", "application/json")
  .body("{\n  \"clientSecret\": \"<string>\",\n  \"apply\": true,\n  \"flags\": [\n    \"<string>\"\n  ],\n  \"evaluationContext\": {},\n  \"sdk\": {\n    \"customId\": \"<string>\",\n    \"version\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://resolver.eu.confidence.dev/v1/flags:resolve")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"clientSecret\": \"<string>\",\n  \"apply\": true,\n  \"flags\": [\n    \"<string>\"\n  ],\n  \"evaluationContext\": {},\n  \"sdk\": {\n    \"customId\": \"<string>\",\n    \"version\": \"<string>\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "resolvedFlags": [
    {
      "flag": "<string>",
      "variant": "<string>",
      "value": {},
      "flagSchema": {
        "schema": [
          {}
        ]
      },
      "reason": "RESOLVE_REASON_UNSPECIFIED",
      "shouldApply": true
    }
  ],
  "resolveToken": {},
  "resolveId": "<string>"
}

Get Started

Feature Flags

Metrics

Stats

Experiments

Surfaces

IAM

Connectors

Resolves Flag

Body

Response