Create Decisions
curl --request POST \
--url https://api.edenai.run/v3/alpha/decisions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"state": "<string>",
"questions": {},
"model": "<string>",
"tags": {
"client": "acme",
"project": "invoices"
},
"routing": {
"sticky": true,
"allow_fallbacks": true,
"quality_cost": 5,
"allowed_providers": [
"<string>"
],
"zero_data_retention": true,
"ignored_providers": [
"<string>"
],
"order": [
"<string>"
],
"max_price": {
"input": 1,
"output": 1
}
},
"fallbacks": [
"<string>"
],
"metadata": {},
"extra_headers": {},
"extra_body": {}
}
'import requests
url = "https://api.edenai.run/v3/alpha/decisions"
payload = {
"state": "<string>",
"questions": {},
"model": "<string>",
"tags": {
"client": "acme",
"project": "invoices"
},
"routing": {
"sticky": True,
"allow_fallbacks": True,
"quality_cost": 5,
"allowed_providers": ["<string>"],
"zero_data_retention": True,
"ignored_providers": ["<string>"],
"order": ["<string>"],
"max_price": {
"input": 1,
"output": 1
}
},
"fallbacks": ["<string>"],
"metadata": {},
"extra_headers": {},
"extra_body": {}
}
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({
state: '<string>',
questions: {},
model: '<string>',
tags: {client: 'acme', project: 'invoices'},
routing: {
sticky: true,
allow_fallbacks: true,
quality_cost: 5,
allowed_providers: ['<string>'],
zero_data_retention: true,
ignored_providers: ['<string>'],
order: ['<string>'],
max_price: {input: 1, output: 1}
},
fallbacks: ['<string>'],
metadata: {},
extra_headers: {},
extra_body: {}
})
};
fetch('https://api.edenai.run/v3/alpha/decisions', 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://api.edenai.run/v3/alpha/decisions",
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([
'state' => '<string>',
'questions' => [
],
'model' => '<string>',
'tags' => [
'client' => 'acme',
'project' => 'invoices'
],
'routing' => [
'sticky' => true,
'allow_fallbacks' => true,
'quality_cost' => 5,
'allowed_providers' => [
'<string>'
],
'zero_data_retention' => true,
'ignored_providers' => [
'<string>'
],
'order' => [
'<string>'
],
'max_price' => [
'input' => 1,
'output' => 1
]
],
'fallbacks' => [
'<string>'
],
'metadata' => [
],
'extra_headers' => [
],
'extra_body' => [
]
]),
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://api.edenai.run/v3/alpha/decisions"
payload := strings.NewReader("{\n \"state\": \"<string>\",\n \"questions\": {},\n \"model\": \"<string>\",\n \"tags\": {\n \"client\": \"acme\",\n \"project\": \"invoices\"\n },\n \"routing\": {\n \"sticky\": true,\n \"allow_fallbacks\": true,\n \"quality_cost\": 5,\n \"allowed_providers\": [\n \"<string>\"\n ],\n \"zero_data_retention\": true,\n \"ignored_providers\": [\n \"<string>\"\n ],\n \"order\": [\n \"<string>\"\n ],\n \"max_price\": {\n \"input\": 1,\n \"output\": 1\n }\n },\n \"fallbacks\": [\n \"<string>\"\n ],\n \"metadata\": {},\n \"extra_headers\": {},\n \"extra_body\": {}\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://api.edenai.run/v3/alpha/decisions")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"state\": \"<string>\",\n \"questions\": {},\n \"model\": \"<string>\",\n \"tags\": {\n \"client\": \"acme\",\n \"project\": \"invoices\"\n },\n \"routing\": {\n \"sticky\": true,\n \"allow_fallbacks\": true,\n \"quality_cost\": 5,\n \"allowed_providers\": [\n \"<string>\"\n ],\n \"zero_data_retention\": true,\n \"ignored_providers\": [\n \"<string>\"\n ],\n \"order\": [\n \"<string>\"\n ],\n \"max_price\": {\n \"input\": 1,\n \"output\": 1\n }\n },\n \"fallbacks\": [\n \"<string>\"\n ],\n \"metadata\": {},\n \"extra_headers\": {},\n \"extra_body\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.edenai.run/v3/alpha/decisions")
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 \"state\": \"<string>\",\n \"questions\": {},\n \"model\": \"<string>\",\n \"tags\": {\n \"client\": \"acme\",\n \"project\": \"invoices\"\n },\n \"routing\": {\n \"sticky\": true,\n \"allow_fallbacks\": true,\n \"quality_cost\": 5,\n \"allowed_providers\": [\n \"<string>\"\n ],\n \"zero_data_retention\": true,\n \"ignored_providers\": [\n \"<string>\"\n ],\n \"order\": [\n \"<string>\"\n ],\n \"max_price\": {\n \"input\": 1,\n \"output\": 1\n }\n },\n \"fallbacks\": [\n \"<string>\"\n ],\n \"metadata\": {},\n \"extra_headers\": {},\n \"extra_body\": {}\n}"
response = http.request(request)
puts response.read_body{
"model": "<string>",
"answers": {},
"usage": {
"input_tokens": 0,
"output_tokens": 0
},
"cost": 123,
"provider": "<string>",
"id": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Decisions
Create Decisions
TypeSafe-compatible System One decisions endpoint.
POST
/
v3
/
alpha
/
decisions
Create Decisions
curl --request POST \
--url https://api.edenai.run/v3/alpha/decisions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"state": "<string>",
"questions": {},
"model": "<string>",
"tags": {
"client": "acme",
"project": "invoices"
},
"routing": {
"sticky": true,
"allow_fallbacks": true,
"quality_cost": 5,
"allowed_providers": [
"<string>"
],
"zero_data_retention": true,
"ignored_providers": [
"<string>"
],
"order": [
"<string>"
],
"max_price": {
"input": 1,
"output": 1
}
},
"fallbacks": [
"<string>"
],
"metadata": {},
"extra_headers": {},
"extra_body": {}
}
'import requests
url = "https://api.edenai.run/v3/alpha/decisions"
payload = {
"state": "<string>",
"questions": {},
"model": "<string>",
"tags": {
"client": "acme",
"project": "invoices"
},
"routing": {
"sticky": True,
"allow_fallbacks": True,
"quality_cost": 5,
"allowed_providers": ["<string>"],
"zero_data_retention": True,
"ignored_providers": ["<string>"],
"order": ["<string>"],
"max_price": {
"input": 1,
"output": 1
}
},
"fallbacks": ["<string>"],
"metadata": {},
"extra_headers": {},
"extra_body": {}
}
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({
state: '<string>',
questions: {},
model: '<string>',
tags: {client: 'acme', project: 'invoices'},
routing: {
sticky: true,
allow_fallbacks: true,
quality_cost: 5,
allowed_providers: ['<string>'],
zero_data_retention: true,
ignored_providers: ['<string>'],
order: ['<string>'],
max_price: {input: 1, output: 1}
},
fallbacks: ['<string>'],
metadata: {},
extra_headers: {},
extra_body: {}
})
};
fetch('https://api.edenai.run/v3/alpha/decisions', 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://api.edenai.run/v3/alpha/decisions",
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([
'state' => '<string>',
'questions' => [
],
'model' => '<string>',
'tags' => [
'client' => 'acme',
'project' => 'invoices'
],
'routing' => [
'sticky' => true,
'allow_fallbacks' => true,
'quality_cost' => 5,
'allowed_providers' => [
'<string>'
],
'zero_data_retention' => true,
'ignored_providers' => [
'<string>'
],
'order' => [
'<string>'
],
'max_price' => [
'input' => 1,
'output' => 1
]
],
'fallbacks' => [
'<string>'
],
'metadata' => [
],
'extra_headers' => [
],
'extra_body' => [
]
]),
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://api.edenai.run/v3/alpha/decisions"
payload := strings.NewReader("{\n \"state\": \"<string>\",\n \"questions\": {},\n \"model\": \"<string>\",\n \"tags\": {\n \"client\": \"acme\",\n \"project\": \"invoices\"\n },\n \"routing\": {\n \"sticky\": true,\n \"allow_fallbacks\": true,\n \"quality_cost\": 5,\n \"allowed_providers\": [\n \"<string>\"\n ],\n \"zero_data_retention\": true,\n \"ignored_providers\": [\n \"<string>\"\n ],\n \"order\": [\n \"<string>\"\n ],\n \"max_price\": {\n \"input\": 1,\n \"output\": 1\n }\n },\n \"fallbacks\": [\n \"<string>\"\n ],\n \"metadata\": {},\n \"extra_headers\": {},\n \"extra_body\": {}\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://api.edenai.run/v3/alpha/decisions")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"state\": \"<string>\",\n \"questions\": {},\n \"model\": \"<string>\",\n \"tags\": {\n \"client\": \"acme\",\n \"project\": \"invoices\"\n },\n \"routing\": {\n \"sticky\": true,\n \"allow_fallbacks\": true,\n \"quality_cost\": 5,\n \"allowed_providers\": [\n \"<string>\"\n ],\n \"zero_data_retention\": true,\n \"ignored_providers\": [\n \"<string>\"\n ],\n \"order\": [\n \"<string>\"\n ],\n \"max_price\": {\n \"input\": 1,\n \"output\": 1\n }\n },\n \"fallbacks\": [\n \"<string>\"\n ],\n \"metadata\": {},\n \"extra_headers\": {},\n \"extra_body\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.edenai.run/v3/alpha/decisions")
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 \"state\": \"<string>\",\n \"questions\": {},\n \"model\": \"<string>\",\n \"tags\": {\n \"client\": \"acme\",\n \"project\": \"invoices\"\n },\n \"routing\": {\n \"sticky\": true,\n \"allow_fallbacks\": true,\n \"quality_cost\": 5,\n \"allowed_providers\": [\n \"<string>\"\n ],\n \"zero_data_retention\": true,\n \"ignored_providers\": [\n \"<string>\"\n ],\n \"order\": [\n \"<string>\"\n ],\n \"max_price\": {\n \"input\": 1,\n \"output\": 1\n }\n },\n \"fallbacks\": [\n \"<string>\"\n ],\n \"metadata\": {},\n \"extra_headers\": {},\n \"extra_body\": {}\n}"
response = http.request(request)
puts response.read_body{
"model": "<string>",
"answers": {},
"usage": {
"input_tokens": 0,
"output_tokens": 0
},
"cost": 123,
"provider": "<string>",
"id": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
TypeSafe's POST /v1/systemone request body, plus minimal Eden extensions.
Unknown top-level fields are forwarded to the provider (extra="allow" via the base
mixin, which also rejects connection keys).
routing (from ProviderRoutingBody) and fallbacks are declared so prepare_input
reads them validated. Routing policies, router_candidates and session_id are not
supported on decisions; chat, Responses and Anthropic Messages accept them.
The content to decide about: a plain string, or a JSON object / array of related context.
Typed questions keyed by name: noul (yes/no probability), choice (one of the criteria keys) or score (position on the ordered criteria rubric).
Show child attributes
Show child attributes
Model identifier in 'provider/model' format, e.g. 'typesafe/jev-latest'.
Up to 10 key/value labels recorded with this call, for filtering and grouping usage. Merged with the X-EdenAI-Tags header.
Example:
{ "client": "acme", "project": "invoices" }
How to pick between the providers that serve the requested model. Applies when model is a model name with no provider prefix (e.g. 'gpt-5.5'); ignored for a concrete 'provider/model' id, which already names its provider, except zero_data_retention, which holds every model in the request to it. With model='@edenai' the platform chooses the model too: quality_cost steers that choice, and the provider fields apply whenever the chosen model is a provider-less name.
Show child attributes
Show child attributes
Decision models to try, in order, if the primary model fails. Each is a 'provider/model' id or a model name with no provider prefix. Example: ['typesafe/jev-latest'].
Maximum array length:
7Arbitrary metadata attached to the request.
Additional HTTP headers forwarded to the provider API.
Show child attributes
Show child attributes
Additional body fields forwarded to the provider API.
Response
Successful Response
TypeSafe's response (typed answers, usage, request id) + Eden cost and provider.