Create Variant - Confidence Documentation

POST

/

v1

/

flags

/

{flag}

/

variants

Create Variant

curl --request POST \
  --url https://flags.eu.confidence.dev/v1/flags/{flag}/variants \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "value": {},
  "labels": [
    {}
  ],
  "description": "<string>",
  "imageUri": "<string>"
}
'

import requests

url = "https://flags.eu.confidence.dev/v1/flags/{flag}/variants"

payload = {
    "name": "<string>",
    "value": {},
    "labels": [{}],
    "description": "<string>",
    "imageUri": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    value: {},
    labels: [{}],
    description: '<string>',
    imageUri: '<string>'
  })
};

fetch('https://flags.eu.confidence.dev/v1/flags/{flag}/variants', 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://flags.eu.confidence.dev/v1/flags/{flag}/variants",
  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([
    'name' => '<string>',
    'value' => [
        
    ],
    'labels' => [
        [
                
        ]
    ],
    'description' => '<string>',
    'imageUri' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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://flags.eu.confidence.dev/v1/flags/{flag}/variants"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"value\": {},\n  \"labels\": [\n    {}\n  ],\n  \"description\": \"<string>\",\n  \"imageUri\": \"<string>\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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://flags.eu.confidence.dev/v1/flags/{flag}/variants")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"value\": {},\n  \"labels\": [\n    {}\n  ],\n  \"description\": \"<string>\",\n  \"imageUri\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://flags.eu.confidence.dev/v1/flags/{flag}/variants")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"value\": {},\n  \"labels\": [\n    {}\n  ],\n  \"description\": \"<string>\",\n  \"imageUri\": \"<string>\"\n}"

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

{
  "name": "<string>",
  "value": {},
  "createTime": {},
  "updateTime": {},
  "creator": "<string>",
  "updater": "<string>",
  "labels": [
    {}
  ],
  "description": "<string>",
  "imageUri": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

flag

string

required

Query Parameters

variantId

string

The ID to use for the variant, which will become the final component of the variant's resource name.

This value should be 4-63 characters, and valid characters are /[a-z][0-9]-/.

Body

application/json

name

string

required

The resource name of the variant. For example: flags/my-flag/variants/control

value

object

required

The value that this variant represents. A possibly nested json object.

labels

object[]

General set of labels for this resource.

Show child attributes

description

string

A human-friendly description of the variant.

imageUri

string

An image URL or path for the variant.

Response

200 - application/json

Returns a Flag.Variant.

A possible named value the flag can assign.

name

string

required

The resource name of the variant. For example: flags/my-flag/variants/control

value

object

required

The value that this variant represents. A possibly nested json object.

createTime

object

required

Time when the flag was first created.

updateTime

object

required

Time when the flag was last updated.

creator

string

required

Reference to the identity that created this variant.

updater

string

required

Reference to the identity that last updated this variant.

labels

object[]

General set of labels for this resource.

Show child attributes

description

string

A human-friendly description of the variant.

imageUri

string

An image URL or path for the variant.

⌘I

Create Variant

curl --request POST \
  --url https://flags.eu.confidence.dev/v1/flags/{flag}/variants \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "value": {},
  "labels": [
    {}
  ],
  "description": "<string>",
  "imageUri": "<string>"
}
'

import requests

url = "https://flags.eu.confidence.dev/v1/flags/{flag}/variants"

payload = {
    "name": "<string>",
    "value": {},
    "labels": [{}],
    "description": "<string>",
    "imageUri": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    value: {},
    labels: [{}],
    description: '<string>',
    imageUri: '<string>'
  })
};

fetch('https://flags.eu.confidence.dev/v1/flags/{flag}/variants', 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://flags.eu.confidence.dev/v1/flags/{flag}/variants",
  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([
    'name' => '<string>',
    'value' => [
        
    ],
    'labels' => [
        [
                
        ]
    ],
    'description' => '<string>',
    'imageUri' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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://flags.eu.confidence.dev/v1/flags/{flag}/variants"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"value\": {},\n  \"labels\": [\n    {}\n  ],\n  \"description\": \"<string>\",\n  \"imageUri\": \"<string>\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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://flags.eu.confidence.dev/v1/flags/{flag}/variants")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"value\": {},\n  \"labels\": [\n    {}\n  ],\n  \"description\": \"<string>\",\n  \"imageUri\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://flags.eu.confidence.dev/v1/flags/{flag}/variants")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"value\": {},\n  \"labels\": [\n    {}\n  ],\n  \"description\": \"<string>\",\n  \"imageUri\": \"<string>\"\n}"

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

{
  "name": "<string>",
  "value": {},
  "createTime": {},
  "updateTime": {},
  "creator": "<string>",
  "updater": "<string>",
  "labels": [
    {}
  ],
  "description": "<string>",
  "imageUri": "<string>"
}