Decisions

Get typed judgments (probability, choice, or score) from models through Portkey’s /v1/decisions endpoint.

Available on all Portkey plans.

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://api.portkey.ai/v1/decisions \
  -H "Content-Type: application/json" \
  -H "x-portkey-api-key: $PORTKEY_API_KEY" \
  -H "x-portkey-provider: typesafe" \
  -H "Authorization: Bearer $TYPESAFE_API_KEY" \
  -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

---

Portkey is now PRISMA AIRS AI Gateway. See it in action.

Contact Us