Create decision

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
  }
}

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
  }
}

How are credits checked?

GPT-6 Luna Decisions uses input-only pricing with a separate long-context tier, not its chat rates. Gumloop checks credits before sending the request to a provider; insufficient credits return HTTP 402 credit_limit_exceeded. A provider call whose cost is fully waived because you use your own API key is exempt from this preflight.

Which question type should I use?

Choose your own question ids. Each answer uses the same id as its question.

Type	Criteria	Answer
`noul`	Optional `true` and `false` descriptions	`noul`, the probability of yes
`choice`	Option ids mapped to descriptions, which may be `null`	Selected `choice`, with optional option `probabilities` and `confidence`
`score`	A list describing your scoring levels	Numerical `score`, with optional level `probabilities`, `legend`, and `confidence`

state, instructions, and individual criteria descriptions can be strings, JSON objects, or arrays. The API uses the same OpenRouter-shaped Decisions schema for both Jev and GPT-6 Luna. Gumloop translates it to OpenAI’s schema for Luna, so keep noul for yes/no questions.

Which models and request options are supported?

Use an id from GET /models with supports_decisions: true: typesafe/jev-1.14, typesafe/jev-1.13 through OpenRouter, or gpt-6-luna directly through OpenAI. is_classifier_model: true means decisions-only. GPT-6 Luna also supports POST /chat/completions under the same id.

Unknown or restricted ids, models without Decisions support, and unsupported proxy configurations return model_unavailable. The endpoint does not select a fallback model.
Responses are not streamed.
provider preferences apply to OpenRouter, not OpenAI. Gumloop applies its zero-data-retention policy after OpenRouter preferences; you cannot disable it. OpenAI requests do not forward the provider field.
The response model identifies the exact served version. Usage records retain that version too.
If OpenAI refuses any question, the request returns HTTP 422 (provider_error). details.provider_message names the refused question ids, and the request does not return partial answers.
For OpenAI, user is sent as safety_identifier, truncated to 128 characters.

How are requests billed?

Charges follow your pricing and bring-your-own-key (BYOK) policy. Gumloop uses the provider-reported cost when positive, or the model’s Decisions catalog token rates when the cost is zero or absent. See Credits.GPT-6 Luna Decisions uses input-only pricing, with a separate long-context tier. There are no separate output or cache charges. Its Decisions rates differ from its chat rates.Approved calls from an agent script are attributed to the current task under Chat & Reasoning. See Code sandbox & secrets.

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-capable model id. Use an id from GET /models whose supports_decisions is true, such as typesafe/jev-1.13 or gpt-6-luna.

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, not forwarded to OpenAI. The server applies its zero-data-retention policy last for OpenRouter. 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 | null

Observability metadata. Unrecognized keys are ignored, not forwarded.

Show child attributes

user

string

A stable id for your end user. The provider uses it for abuse monitoring. OpenAI receives it as safety_identifier, truncated to 128 characters.

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

Agents

Sessions

Skills

Artifacts

MCP

Browser profiles

Personal wiki

Evaluations

Organization evaluations

Brain

Teams

Models

File operations

Enterprise organization

Create decision

Authorizations

Query Parameters

Body

Response