cURL

curl -X POST 'https://api.gumloop.com/api/v1/decisions' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "typesafe/jev-1.13",
    "state": {"ticket": "My checkout page shows a blank screen after I click Pay."},
    "questions": {
      "is_bug": {"type": "noul", "instructions": "Is the customer reporting a software defect?"},
      "team": {"type": "choice", "instructions": "Which team should own this ticket?",
               "criteria": {"payments": "Checkout, billing", "frontend": "Rendering, layout", "account": "Login, permissions"}},
      "urgency": {"type": "score", "instructions": "How urgent is this ticket?",
                  "criteria": ["Can wait for the next release", "Should be fixed this week", "Blocking revenue right now"]}
    }
  }'

import requests

response = requests.post(
    "https://api.gumloop.com/api/v1/decisions",
    headers={"Authorization": "Bearer YOUR_ACCESS_TOKEN"},
    json={
        "model": "typesafe/jev-1.13",
        "state": {"ticket": "My checkout page shows a blank screen after I click Pay."},
        "questions": {
            "is_bug": {"type": "noul", "instructions": "Is the customer reporting a software defect?"},
            "team": {
                "type": "choice",
                "instructions": "Which team should own this ticket?",
                "criteria": {"payments": "Checkout, billing", "frontend": "Rendering, layout", "account": "Login, permissions"},
            },
            "urgency": {
                "type": "score",
                "instructions": "How urgent is this ticket?",
                "criteria": ["Can wait for the next release", "Should be fixed this week", "Blocking revenue right now"],
            },
        },
    },
)
answers = response.json()["answers"]
if answers["is_bug"]["noul"] > 0.8:
    route_to(answers["team"]["choice"])

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'typesafe/jev-1.13',
    state: {ticket: 'My checkout page shows a blank screen after I click Pay.'},
    questions: {
      is_bug: {type: 'noul', instructions: 'Is the customer reporting a software defect?'},
      team: {
        type: 'choice',
        instructions: 'Which team should own this ticket?',
        criteria: {
          payments: 'Checkout, billing',
          frontend: 'Rendering, layout',
          account: 'Login, permissions'
        }
      },
      urgency: {
        type: 'score',
        instructions: 'How urgent is this ticket?',
        criteria: [
          'Can wait for the next release',
          'Should be fixed this week',
          'Blocking revenue right now'
        ]
      }
    }
  })
};

fetch('https://api.gumloop.com/api/v1/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.gumloop.com/api/v1/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([
    'model' => 'typesafe/jev-1.13',
    'state' => [
        'ticket' => 'My checkout page shows a blank screen after I click Pay.'
    ],
    'questions' => [
        'is_bug' => [
                'type' => 'noul',
                'instructions' => 'Is the customer reporting a software defect?'
        ],
        'team' => [
                'type' => 'choice',
                'instructions' => 'Which team should own this ticket?',
                'criteria' => [
                                'payments' => 'Checkout, billing',
                                'frontend' => 'Rendering, layout',
                                'account' => 'Login, permissions'
                ]
        ],
        'urgency' => [
                'type' => 'score',
                'instructions' => 'How urgent is this ticket?',
                'criteria' => [
                                'Can wait for the next release',
                                'Should be fixed this week',
                                'Blocking revenue right now'
                ]
        ]
    ]
  ]),
  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.gumloop.com/api/v1/decisions"

	payload := strings.NewReader("{\n  \"model\": \"typesafe/jev-1.13\",\n  \"state\": {\n    \"ticket\": \"My checkout page shows a blank screen after I click Pay.\"\n  },\n  \"questions\": {\n    \"is_bug\": {\n      \"type\": \"noul\",\n      \"instructions\": \"Is the customer reporting a software defect?\"\n    },\n    \"team\": {\n      \"type\": \"choice\",\n      \"instructions\": \"Which team should own this ticket?\",\n      \"criteria\": {\n        \"payments\": \"Checkout, billing\",\n        \"frontend\": \"Rendering, layout\",\n        \"account\": \"Login, permissions\"\n      }\n    },\n    \"urgency\": {\n      \"type\": \"score\",\n      \"instructions\": \"How urgent is this ticket?\",\n      \"criteria\": [\n        \"Can wait for the next release\",\n        \"Should be fixed this week\",\n        \"Blocking revenue right now\"\n      ]\n    }\n  }\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.gumloop.com/api/v1/decisions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"typesafe/jev-1.13\",\n  \"state\": {\n    \"ticket\": \"My checkout page shows a blank screen after I click Pay.\"\n  },\n  \"questions\": {\n    \"is_bug\": {\n      \"type\": \"noul\",\n      \"instructions\": \"Is the customer reporting a software defect?\"\n    },\n    \"team\": {\n      \"type\": \"choice\",\n      \"instructions\": \"Which team should own this ticket?\",\n      \"criteria\": {\n        \"payments\": \"Checkout, billing\",\n        \"frontend\": \"Rendering, layout\",\n        \"account\": \"Login, permissions\"\n      }\n    },\n    \"urgency\": {\n      \"type\": \"score\",\n      \"instructions\": \"How urgent is this ticket?\",\n      \"criteria\": [\n        \"Can wait for the next release\",\n        \"Should be fixed this week\",\n        \"Blocking revenue right now\"\n      ]\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gumloop.com/api/v1/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  \"model\": \"typesafe/jev-1.13\",\n  \"state\": {\n    \"ticket\": \"My checkout page shows a blank screen after I click Pay.\"\n  },\n  \"questions\": {\n    \"is_bug\": {\n      \"type\": \"noul\",\n      \"instructions\": \"Is the customer reporting a software defect?\"\n    },\n    \"team\": {\n      \"type\": \"choice\",\n      \"instructions\": \"Which team should own this ticket?\",\n      \"criteria\": {\n        \"payments\": \"Checkout, billing\",\n        \"frontend\": \"Rendering, layout\",\n        \"account\": \"Login, permissions\"\n      }\n    },\n    \"urgency\": {\n      \"type\": \"score\",\n      \"instructions\": \"How urgent is this ticket?\",\n      \"criteria\": [\n        \"Can wait for the next release\",\n        \"Should be fixed this week\",\n        \"Blocking revenue right now\"\n      ]\n    }\n  }\n}"

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

{
  "id": "gen-dec-1790835808-rFEEP39lhplllf50bn9Q",
  "model": "typesafe/jev-1.13-20260917",
  "provider": "TypeSafe",
  "answers": {
    "is_bug": {
      "type": "noul",
      "noul": 0.94
    },
    "team": {
      "type": "choice",
      "choice": "payments",
      "confidence": 0.37,
      "probabilities": {
        "payments": 0.58,
        "frontend": 0.42,
        "account": 0
      }
    },
    "urgency": {
      "type": "score",
      "score": 1.92,
      "confidence": 0.88,
      "legend": {
        "0": "Can wait for the next release",
        "1": "Should be fixed this week",
        "2": "Blocking revenue right now"
      },
      "probabilities": {
        "0": 0,
        "1": 0.07,
        "2": 0.93
      }
    }
  },
  "usage": {
    "input_tokens": 380,
    "output_tokens": 70,
    "cost": 0
  }
}

Create decision

Ask a decision model one or more typed questions about a piece of state. The model returns a probability for each question instead of text. The request and response use the OpenRouter Decisions schema. Jev (typesafe/jev-1.13) is the first decision model. Any model with is_classifier_model: true in GET /models works here. Chat models are refused with model_unavailable. Send those to POST /chat/completions.

You choose the question ids. The answers come back under the same ids. There are three question types:

noul is a yes/no question. The answer is noul, the probability of yes. criteria.true and criteria.false are optional descriptions of each side.
choice picks one option from criteria, a map of option id to description. A description may be null. The answer is choice, probabilities over every option, and confidence.
score places the state on the ordered rubric in criteria, a list with the lowest level first. The answer is score (the weighted position), probabilities per level, legend, and confidence.

state, instructions and criteria accept a string, a JSON object, or an array. The response model is the exact version the provider served, for example typesafe/jev-1.13-20260917. Billing uses the model you requested. There is no streaming form. The server applies its zero-data-retention provider policy after any provider preferences you send.

Billing

Each call charges the caller’s credit balance from the provider-reported cost, or from the model’s token rate when the provider reports none. A call costs at least one credit, so put every independent question about one piece of state in a single request.

POST

decisions

cURL

curl -X POST 'https://api.gumloop.com/api/v1/decisions' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "typesafe/jev-1.13",
    "state": {"ticket": "My checkout page shows a blank screen after I click Pay."},
    "questions": {
      "is_bug": {"type": "noul", "instructions": "Is the customer reporting a software defect?"},
      "team": {"type": "choice", "instructions": "Which team should own this ticket?",
               "criteria": {"payments": "Checkout, billing", "frontend": "Rendering, layout", "account": "Login, permissions"}},
      "urgency": {"type": "score", "instructions": "How urgent is this ticket?",
                  "criteria": ["Can wait for the next release", "Should be fixed this week", "Blocking revenue right now"]}
    }
  }'

import requests

response = requests.post(
    "https://api.gumloop.com/api/v1/decisions",
    headers={"Authorization": "Bearer YOUR_ACCESS_TOKEN"},
    json={
        "model": "typesafe/jev-1.13",
        "state": {"ticket": "My checkout page shows a blank screen after I click Pay."},
        "questions": {
            "is_bug": {"type": "noul", "instructions": "Is the customer reporting a software defect?"},
            "team": {
                "type": "choice",
                "instructions": "Which team should own this ticket?",
                "criteria": {"payments": "Checkout, billing", "frontend": "Rendering, layout", "account": "Login, permissions"},
            },
            "urgency": {
                "type": "score",
                "instructions": "How urgent is this ticket?",
                "criteria": ["Can wait for the next release", "Should be fixed this week", "Blocking revenue right now"],
            },
        },
    },
)
answers = response.json()["answers"]
if answers["is_bug"]["noul"] > 0.8:
    route_to(answers["team"]["choice"])

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'typesafe/jev-1.13',
    state: {ticket: 'My checkout page shows a blank screen after I click Pay.'},
    questions: {
      is_bug: {type: 'noul', instructions: 'Is the customer reporting a software defect?'},
      team: {
        type: 'choice',
        instructions: 'Which team should own this ticket?',
        criteria: {
          payments: 'Checkout, billing',
          frontend: 'Rendering, layout',
          account: 'Login, permissions'
        }
      },
      urgency: {
        type: 'score',
        instructions: 'How urgent is this ticket?',
        criteria: [
          'Can wait for the next release',
          'Should be fixed this week',
          'Blocking revenue right now'
        ]
      }
    }
  })
};

fetch('https://api.gumloop.com/api/v1/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.gumloop.com/api/v1/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([
    'model' => 'typesafe/jev-1.13',
    'state' => [
        'ticket' => 'My checkout page shows a blank screen after I click Pay.'
    ],
    'questions' => [
        'is_bug' => [
                'type' => 'noul',
                'instructions' => 'Is the customer reporting a software defect?'
        ],
        'team' => [
                'type' => 'choice',
                'instructions' => 'Which team should own this ticket?',
                'criteria' => [
                                'payments' => 'Checkout, billing',
                                'frontend' => 'Rendering, layout',
                                'account' => 'Login, permissions'
                ]
        ],
        'urgency' => [
                'type' => 'score',
                'instructions' => 'How urgent is this ticket?',
                'criteria' => [
                                'Can wait for the next release',
                                'Should be fixed this week',
                                'Blocking revenue right now'
                ]
        ]
    ]
  ]),
  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.gumloop.com/api/v1/decisions"

	payload := strings.NewReader("{\n  \"model\": \"typesafe/jev-1.13\",\n  \"state\": {\n    \"ticket\": \"My checkout page shows a blank screen after I click Pay.\"\n  },\n  \"questions\": {\n    \"is_bug\": {\n      \"type\": \"noul\",\n      \"instructions\": \"Is the customer reporting a software defect?\"\n    },\n    \"team\": {\n      \"type\": \"choice\",\n      \"instructions\": \"Which team should own this ticket?\",\n      \"criteria\": {\n        \"payments\": \"Checkout, billing\",\n        \"frontend\": \"Rendering, layout\",\n        \"account\": \"Login, permissions\"\n      }\n    },\n    \"urgency\": {\n      \"type\": \"score\",\n      \"instructions\": \"How urgent is this ticket?\",\n      \"criteria\": [\n        \"Can wait for the next release\",\n        \"Should be fixed this week\",\n        \"Blocking revenue right now\"\n      ]\n    }\n  }\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.gumloop.com/api/v1/decisions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"typesafe/jev-1.13\",\n  \"state\": {\n    \"ticket\": \"My checkout page shows a blank screen after I click Pay.\"\n  },\n  \"questions\": {\n    \"is_bug\": {\n      \"type\": \"noul\",\n      \"instructions\": \"Is the customer reporting a software defect?\"\n    },\n    \"team\": {\n      \"type\": \"choice\",\n      \"instructions\": \"Which team should own this ticket?\",\n      \"criteria\": {\n        \"payments\": \"Checkout, billing\",\n        \"frontend\": \"Rendering, layout\",\n        \"account\": \"Login, permissions\"\n      }\n    },\n    \"urgency\": {\n      \"type\": \"score\",\n      \"instructions\": \"How urgent is this ticket?\",\n      \"criteria\": [\n        \"Can wait for the next release\",\n        \"Should be fixed this week\",\n        \"Blocking revenue right now\"\n      ]\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gumloop.com/api/v1/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  \"model\": \"typesafe/jev-1.13\",\n  \"state\": {\n    \"ticket\": \"My checkout page shows a blank screen after I click Pay.\"\n  },\n  \"questions\": {\n    \"is_bug\": {\n      \"type\": \"noul\",\n      \"instructions\": \"Is the customer reporting a software defect?\"\n    },\n    \"team\": {\n      \"type\": \"choice\",\n      \"instructions\": \"Which team should own this ticket?\",\n      \"criteria\": {\n        \"payments\": \"Checkout, billing\",\n        \"frontend\": \"Rendering, layout\",\n        \"account\": \"Login, permissions\"\n      }\n    },\n    \"urgency\": {\n      \"type\": \"score\",\n      \"instructions\": \"How urgent is this ticket?\",\n      \"criteria\": [\n        \"Can wait for the next release\",\n        \"Should be fixed this week\",\n        \"Blocking revenue right now\"\n      ]\n    }\n  }\n}"

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

{
  "id": "gen-dec-1790835808-rFEEP39lhplllf50bn9Q",
  "model": "typesafe/jev-1.13-20260917",
  "provider": "TypeSafe",
  "answers": {
    "is_bug": {
      "type": "noul",
      "noul": 0.94
    },
    "team": {
      "type": "choice",
      "choice": "payments",
      "confidence": 0.37,
      "probabilities": {
        "payments": 0.58,
        "frontend": 0.42,
        "account": 0
      }
    },
    "urgency": {
      "type": "score",
      "score": 1.92,
      "confidence": 0.88,
      "legend": {
        "0": "Can wait for the next release",
        "1": "Should be fixed this week",
        "2": "Blocking revenue right now"
      },
      "probabilities": {
        "0": 0,
        "1": 0.07,
        "2": 0.93
      }
    }
  },
  "usage": {
    "input_tokens": 380,
    "output_tokens": 70,
    "cost": 0
  }
}

Authorizations

Authorization

string

header

required

A personal API key or an OAuth 2.0 access token. Personal API keys also require the x-auth-key header with your user ID.

Query Parameters

team_id

string

Scope the request to a team. When omitted, uses the authenticated user's default organization.

Body

application/json

model

string

required

Decision model id. Use an id from GET /models whose is_classifier_model is true.

Example:

"typesafe/jev-1.13"

state

required

The content to evaluate. A plain string, or a JSON object or array of related context.

questions

object

required

Questions keyed by ids you choose. Answers come back under the same ids.

Show child attributes

provider

object

OpenRouter provider routing preferences. The server applies its zero-data-retention policy last. You cannot turn it off.

session_id

string

Groups related requests in observability tooling. Not sent to the model.

Maximum string length: 256

trace

object

Observability metadata (trace_id, trace_name, span_name, generation_name, parent_span_id, plus custom keys).

user

string

A stable id for your end user. The provider uses it for abuse monitoring.

Response

One answer per question, under the question's id.

string

Example:

"gen-dec-1790835808-rFEEP39lhplllf50bn9Q"

model

string

The exact model version that answered.

Example:

"typesafe/jev-1.13-20260917"

provider

string

Example:

"TypeSafe"

answers

object

Keyed by your question ids. The fields present depend on the question type.

Show child attributes

usage

object

Show child attributes

Core concepts

SDKs

Agents

Sessions

Skills

Artifacts

MCP

Browser profiles

Evaluations

Organization evaluations

Brain

Teams

Models

File operations

Enterprise organization

Create decision

Billing

Authorizations

Query Parameters

Body

Response