Decide makes feature decisions for the selected query parameters.

1 min

POST

/v1/decide

Returns decision results for flag keys for a user. The result for a single key is returned as an OptimizelyDecision object whereas the result for multiple keys is returned as an array of OptimizelyDecision objects. If no flag key is provided, decision is made for all flag keys. OptimizelyDecision object contains all data required to deliver the flag rule.

Query Parameters

keysstring
Description
Flag keys for decision

Body Parameters

bodyDecideContextrequired
- decideOptionsDecideOption[]
- userIdstringrequired
- userAttributesobject
- forcedDecisionsForcedDecision[]
  - flagKeystringrequired
  - ruleKeystring
  - variationKeystringrequired
- fetchSegmentsboolean
- fetchSegmentsOptionsFetchSegmentsOption[]

Responses

200Valid response

object
- objectOptimizelyDecision[]
  - variablesobject
  - variationKeystring
  - enabledboolean
  - ruleKeystringrequired
  - flagKeystringrequired
  - userContextUserContextrequired
    - userIdstringrequired
    - attributesobject
  - reasonsstring[]
- objectOptimizelyDecision
  - variablesobject
  - variationKeystring
  - enabledboolean
  - ruleKeystringrequired
  - flagKeystringrequired
  - userContextUserContextrequired
    - userIdstringrequired
    - attributesobject
  - reasonsstring[]

400Missing required parameters

401

Unauthorized, invalid JWT

403You do not have necessary permissions for the resource

Error
- errorstring

500Failed to fetch qualified segments

curl

curl --request POST \
     --url /v1/decide \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "userId": "",
     "forcedDecisions": [
     {
     "flagKey": "",
     "variationKey": ""
     }
     ]
     }'

javascript

var myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/json");

var raw = JSON.stringify({
   "userId": "",
   "forcedDecisions": [
      {
         "flagKey": "",
         "variationKey": ""
      }
   ]
});

var requestOptions = {
   method: 'POST',
   headers: myHeaders,
   body: raw,
   redirect: 'follow'
};

fetch("/v1/decide", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

ruby

require "uri"
require "json"
require "net/http"

url = URI("/v1/decide")

http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Post.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request.body = JSON.dump({
   "userId": "",
   "forcedDecisions": [
      {
         "flagKey": "",
         "variationKey": ""
      }
   ]
})

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

python

import requests
import json

url = "/v1/decide"

payload = json.dumps({
   "userId": "",
   "forcedDecisions": [
      {
         "flagKey": "",
         "variationKey": ""
      }
   ]
})
headers = {
   'accept': 'application/json',
   'content-type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

200

// Valid response
{}

400

// Missing required parameters

401

// Unauthorized, invalid JWT

403

// You do not have necessary permissions for the resource
{
  "error": ""
}

500

// Failed to fetch qualified segments