Decisions

The Decisions API returns a typed judgment instead of generated text. You send a state and a set of questions. The model returns one typed answer for each question. Use it for classification, routing, scoring, and yes/no checks, where you need a structured answer and not free text.

/v1/decisions is currently available through TypeSafe’s Jev models. It does not support streaming.

Quick Start

cURL

curl https://aigw.portkey.ai/v1/decisions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PORTKEY_API_KEY" \
  -H "x-portkey-provider: typesafe" \
  -d '{
    "model": "jev-latest",
    "state": "Help! My payouts have been failing for 3 days.",
    "questions": {
      "department": {
        "type": "choice",
        "instructions": "Which team should handle this?",
        "criteria": { "billing": "Payments", "technical": "Bugs" }
      }
    }
  }'

Response:

{
  "model": "jev-1.13.0",
  "answers": {
    "department": {
      "type": "choice",
      "choice": "billing",
      "probabilities": { "billing": 0.88, "technical": 0.12 },
      "confidence": 0.81
    }
  },
  "usage": { "input_tokens": 296, "output_tokens": 20 },
  "provider": "typesafe"
}

Question Types

Each entry in questions sets a type. The type sets the shape of the answer:

Type	Use for	Answer shape
`noul`	A yes/no judgment	`{ noul: <0–1 probability> }`
`choice`	One label from a fixed set	`{ choice, probabilities, confidence }`
`score`	A position on a scale	`{ score, legend, probabilities, confidence }`

criteria gives the type-specific detail. For a choice question, it is the set of labels.

Gateway Features

Decisions requests go through the same gateway as other endpoints:

Routing — Retries, fallbacks, load balancing, and circuit breaking through Configs
Caching — Simple and semantic caching
Guardrails — Before-request checks on the state field only. See Guardrails for Decisions
Observability — Logs, cost tracking, and analytics in Observability

API Reference

Create a Decision — POST /v1/decisions

TypeSafe

Provider setup and pricing

API Reference

Decisions API reference

Universal API

All API formats

Guardrails for Decisions

Scan state before it reaches the model

Introduction

Product

Quick Start

Question Types

Gateway Features

API Reference

TypeSafe

API Reference

Universal API

Guardrails for Decisions

​Quick Start

​Question Types

​Gateway Features

​API Reference

TypeSafe

API Reference

Universal API

Guardrails for Decisions

Quick Start

Question Types

Gateway Features

API Reference