System One API

POST

systemone

Answer typed questions about a state

curl --request POST \
  --url https://api.morphllm.com/v1/systemone \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "model": "d3-ultra",
  "state": "Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP.",
  "questions": {
    "department": {
      "type": "choice",
      "instructions": "Which team should handle this?",
      "criteria": {
        "billing": "Payment or subscription issues",
        "technical": "Bugs or integration problems",
        "sales": "Pricing or account questions"
      }
    },
    "frustration": {
      "type": "score",
      "instructions": "How frustrated does the customer appear?",
      "criteria": [
        "Calm, just stating facts",
        "Frustrated but civil",
        "Very angry, strong language"
      ]
    },
    "is_urgent": {
      "type": "noul",
      "instructions": "The message conveys urgency or time sensitivity."
    }
  }
}
EOF

import requests

url = "https://api.morphllm.com/v1/systemone"

payload = {
    "model": "d3-ultra",
    "state": "Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP.",
    "questions": {
        "department": {
            "type": "choice",
            "instructions": "Which team should handle this?",
            "criteria": {
                "billing": "Payment or subscription issues",
                "technical": "Bugs or integration problems",
                "sales": "Pricing or account questions"
            }
        },
        "frustration": {
            "type": "score",
            "instructions": "How frustrated does the customer appear?",
            "criteria": ["Calm, just stating facts", "Frustrated but civil", "Very angry, strong language"]
        },
        "is_urgent": {
            "type": "noul",
            "instructions": "The message conveys urgency or time sensitivity."
        }
    }
}
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({
    model: 'd3-ultra',
    state: 'Hi, I\'ve been trying to connect my Stripe account for 3 days and it keeps failing. I\'m losing sales. Please help ASAP.',
    questions: {
      department: {
        type: 'choice',
        instructions: 'Which team should handle this?',
        criteria: {
          billing: 'Payment or subscription issues',
          technical: 'Bugs or integration problems',
          sales: 'Pricing or account questions'
        }
      },
      frustration: {
        type: 'score',
        instructions: 'How frustrated does the customer appear?',
        criteria: [
          'Calm, just stating facts',
          'Frustrated but civil',
          'Very angry, strong language'
        ]
      },
      is_urgent: {type: 'noul', instructions: 'The message conveys urgency or time sensitivity.'}
    }
  })
};

fetch('https://api.morphllm.com/v1/systemone', 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.morphllm.com/v1/systemone",
  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' => 'd3-ultra',
    'state' => 'Hi, I\'ve been trying to connect my Stripe account for 3 days and it keeps failing. I\'m losing sales. Please help ASAP.',
    'questions' => [
        'department' => [
                'type' => 'choice',
                'instructions' => 'Which team should handle this?',
                'criteria' => [
                                'billing' => 'Payment or subscription issues',
                                'technical' => 'Bugs or integration problems',
                                'sales' => 'Pricing or account questions'
                ]
        ],
        'frustration' => [
                'type' => 'score',
                'instructions' => 'How frustrated does the customer appear?',
                'criteria' => [
                                'Calm, just stating facts',
                                'Frustrated but civil',
                                'Very angry, strong language'
                ]
        ],
        'is_urgent' => [
                'type' => 'noul',
                'instructions' => 'The message conveys urgency or time sensitivity.'
        ]
    ]
  ]),
  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.morphllm.com/v1/systemone"

	payload := strings.NewReader("{\n  \"model\": \"d3-ultra\",\n  \"state\": \"Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP.\",\n  \"questions\": {\n    \"department\": {\n      \"type\": \"choice\",\n      \"instructions\": \"Which team should handle this?\",\n      \"criteria\": {\n        \"billing\": \"Payment or subscription issues\",\n        \"technical\": \"Bugs or integration problems\",\n        \"sales\": \"Pricing or account questions\"\n      }\n    },\n    \"frustration\": {\n      \"type\": \"score\",\n      \"instructions\": \"How frustrated does the customer appear?\",\n      \"criteria\": [\n        \"Calm, just stating facts\",\n        \"Frustrated but civil\",\n        \"Very angry, strong language\"\n      ]\n    },\n    \"is_urgent\": {\n      \"type\": \"noul\",\n      \"instructions\": \"The message conveys urgency or time sensitivity.\"\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.morphllm.com/v1/systemone")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"d3-ultra\",\n  \"state\": \"Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP.\",\n  \"questions\": {\n    \"department\": {\n      \"type\": \"choice\",\n      \"instructions\": \"Which team should handle this?\",\n      \"criteria\": {\n        \"billing\": \"Payment or subscription issues\",\n        \"technical\": \"Bugs or integration problems\",\n        \"sales\": \"Pricing or account questions\"\n      }\n    },\n    \"frustration\": {\n      \"type\": \"score\",\n      \"instructions\": \"How frustrated does the customer appear?\",\n      \"criteria\": [\n        \"Calm, just stating facts\",\n        \"Frustrated but civil\",\n        \"Very angry, strong language\"\n      ]\n    },\n    \"is_urgent\": {\n      \"type\": \"noul\",\n      \"instructions\": \"The message conveys urgency or time sensitivity.\"\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.morphllm.com/v1/systemone")

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\": \"d3-ultra\",\n  \"state\": \"Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP.\",\n  \"questions\": {\n    \"department\": {\n      \"type\": \"choice\",\n      \"instructions\": \"Which team should handle this?\",\n      \"criteria\": {\n        \"billing\": \"Payment or subscription issues\",\n        \"technical\": \"Bugs or integration problems\",\n        \"sales\": \"Pricing or account questions\"\n      }\n    },\n    \"frustration\": {\n      \"type\": \"score\",\n      \"instructions\": \"How frustrated does the customer appear?\",\n      \"criteria\": [\n        \"Calm, just stating facts\",\n        \"Frustrated but civil\",\n        \"Very angry, strong language\"\n      ]\n    },\n    \"is_urgent\": {\n      \"type\": \"noul\",\n      \"instructions\": \"The message conveys urgency or time sensitivity.\"\n    }\n  }\n}"

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

{
  "id": "dec-6f1c0b9e2a7d4c3e",
  "object": "structured_decision",
  "created": 1793577600,
  "model": "d3-ultra",
  "answers": {
    "department": {
      "type": "choice",
      "choice": "technical",
      "probabilities": {
        "billing": 0.21,
        "technical": 0.78,
        "sales": 0.01
      },
      "confidence": 0.77
    },
    "frustration": {
      "type": "score",
      "score": 1.3,
      "legend": {
        "0": "Calm, just stating facts",
        "1": "Frustrated but civil",
        "2": "Very angry, strong language"
      },
      "probabilities": {
        "0": 0,
        "1": 0.7,
        "2": 0.3
      },
      "confidence": 0.69
    },
    "is_urgent": {
      "type": "noul",
      "noul": 0.97,
      "probabilities": {
        "yes": 0.97,
        "no": 0.03
      },
      "confidence": 0.96
    }
  },
  "usage": {
    "input_tokens": 312,
    "output_tokens": 0,
    "input_tokens_details": {
      "cached_tokens": 256
    }
  },
  "diagnostics": {
    "department": {
      "label_mass": 0.99,
      "argmax_is_label": true
    },
    "frustration": {
      "label_mass": 0.99,
      "argmax_is_label": true
    },
    "is_urgent": {
      "label_mass": 0.99,
      "argmax_is_label": true
    }
  }
}

{
  "error": {
    "code": "invalid_request_error",
    "message": "The request body is missing the `model` field."
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key provided."
  }
}

{
  "error": {
    "message": "Unknown model 'gpt-5'; use one of ['d3-ultra'].",
    "type": "invalid_request_error",
    "param": "model",
    "code": "model_not_found"
  }
}

{
  "error": {
    "message": "`images` is not supported on this endpoint yet; send a text or JSON state.",
    "type": "invalid_request_error",
    "param": "images",
    "code": null
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Retry in 12 seconds."
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Something went wrong on our side."
  }
}

{
  "error": {
    "message": "The decision engine is unavailable.",
    "type": "api_error",
    "param": null,
    "code": null
  }
}

Overview

Most of what an agent asks a model is not a paragraph. It is “which queue does this ticket go to”, “how severe is this”, “does this message need a human”. Asking a chat model means generating text, parsing it, and hoping the number it wrote reflects anything. System One skips the generation: the model reads the state and reports the probability of every option for every question, so your code branches on numbers. POST /v1/systemone takes a state (text or JSON) and a map of named questions of three types. Every answer is a distribution over the options you gave.

type	ask	answer
`noul`	a yes/no statement	`noul` (the probability of yes), `probabilities`, `confidence`
`choice`	pick one of a set of named options	`choice`, `probabilities` per option, `confidence`
`score`	rate against 2 to 10 ordered levels	`score` (expected level), `probabilities` per level index, `legend`, `confidence`

Model: d3-ultra (26B, vllm-sr/d3-ultra, Apache-2.0), a decision model trained to read a state and answer typed questions about it.

Writing questions

instructions is what you want judged. criteria describes the options: for choice a map of option name to description (or null), for score an ordered list of level descriptions from lowest to highest, for noul an optional {"true": ..., "false": ...} pair. Descriptions do the work: an option the model can only see by name gets answered by the name alone. An optional top-level instructions string is placed ahead of the questions, for context every question shares. Ask every question about one state in one call. Questions are answered in the order you send them.

Reading answers

probabilities sum to 1 per question. choice is the argmax; score is the expected level, so a 3-level scale answering {0: 0.0, 1: 0.7, 2: 0.3} scores 1.3.
confidence (0 to 1) is the probability the model put on the answer it gave, measured over everything it could have produced, not only your options. It equals the answer’s entry in probabilities times diagnostics.<id>.label_mass, so it is never higher than that entry. For score the answer is the most likely level; for noul it is the more likely of yes and no. Gate actions on it: act automatically above a threshold you choose per action, route to a person below it.
diagnostics.<id>.label_mass is how much of the model’s probability landed on your options at all. A low value means the question or its options read poorly to the model; reword them.
usage.input_tokens is the state plus the questions. usage.input_tokens_details.cached_tokens is the part of it served from the prefix cache, billed at the cached-input rate. usage.output_tokens is always 0: nothing is generated.

Pricing

$0.042 per million input tokens, $0.01 per million cached input tokens, no output charge.

Errors

400: the request does not fit the contract (for example a choice with no options, or score criteria that are not a list). The message names the question.
401: missing or invalid key. 429: your key’s rate limit.
404: unknown model.
422: images, audio and videos are not accepted on this endpoint yet.
503: the decision engine is unavailable; retry with exponential backoff.
Every response carries x-request-id.

Switching from another typed-decision API

If you already send {model, state, questions} with noul, choice and score questions to a /v1/systemone endpoint, the bodies are the same here. Change three things: the base URL to https://api.morphllm.com, the key to a Morph key, and model to d3-ultra.

Authorizations

Authorization

string

header

required

Morph API key, passed as Authorization: Bearer sk-.... Create keys at https://www.morphllm.com/dashboard/api-keys.

Body

application/json

The state and the questions to answer about it.

A state and the typed questions to answer about it.

model

string

required

d3-ultra.

Example:

"d3-ultra"

state

required

What the questions are about: text or JSON. Read once per request however many questions follow.

Example:

"Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP."

questions

object

required

Named questions, asked in this order. The answer for each comes back under the same name.

Show child attributes

Example:

{
  "department": {
    "type": "choice",
    "instructions": "Which team should handle this?",
    "criteria": {
      "billing": "Payment or subscription issues",
      "technical": "Bugs or integration problems",
      "sales": "Pricing or account questions"
    }
  },
  "frustration": {
    "type": "score",
    "instructions": "How frustrated does the customer appear?",
    "criteria": [
      "Calm, just stating facts",
      "Frustrated but civil",
      "Very angry, strong language"
    ]
  },
  "is_urgent": {
    "type": "noul",
    "instructions": "The message conveys urgency or time sensitivity."
  }
}

instructions

string

Optional context placed ahead of the questions.

Response

One answer per question.

The answers and what they cost.

string

required

Decision id.

Example:

"dec-6f1c0b9e2a7d4c3e"

object

enum<string>

required

Available options:

structured_decision

created

integer

required

Unix seconds.

Example:

1793577600

model

string

required

The model that answered.

Example:

"d3-ultra"

answers

object

required

One answer per question, under the name you gave it.

Show child attributes

Example:

{
  "department": {
    "type": "choice",
    "choice": "technical",
    "probabilities": {
      "billing": 0.21,
      "technical": 0.78,
      "sales": 0.01
    },
    "confidence": 0.77
  },
  "frustration": {
    "type": "score",
    "score": 1.3,
    "legend": {
      "0": "Calm, just stating facts",
      "1": "Frustrated but civil",
      "2": "Very angry, strong language"
    },
    "probabilities": { "0": 0, "1": 0.7, "2": 0.3 },
    "confidence": 0.69
  },
  "is_urgent": {
    "type": "noul",
    "noul": 0.97,
    "probabilities": { "yes": 0.97, "no": 0.03 },
    "confidence": 0.96
  }
}

usage

object

required

Token accounting for the request.

Show child attributes

diagnostics

object

required

Per question, how much of the model's probability landed on the options.

Show child attributes

Example:

{
  "department": {
    "label_mass": 0.99,
    "argmax_is_label": true
  },
  "frustration": {
    "label_mass": 0.99,
    "argmax_is_label": true
  },
  "is_urgent": {
    "label_mass": 0.99,
    "argmax_is_label": true
  }
}

Answer typed questions about a state

curl --request POST \
  --url https://api.morphllm.com/v1/systemone \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "model": "d3-ultra",
  "state": "Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP.",
  "questions": {
    "department": {
      "type": "choice",
      "instructions": "Which team should handle this?",
      "criteria": {
        "billing": "Payment or subscription issues",
        "technical": "Bugs or integration problems",
        "sales": "Pricing or account questions"
      }
    },
    "frustration": {
      "type": "score",
      "instructions": "How frustrated does the customer appear?",
      "criteria": [
        "Calm, just stating facts",
        "Frustrated but civil",
        "Very angry, strong language"
      ]
    },
    "is_urgent": {
      "type": "noul",
      "instructions": "The message conveys urgency or time sensitivity."
    }
  }
}
EOF

import requests

url = "https://api.morphllm.com/v1/systemone"

payload = {
    "model": "d3-ultra",
    "state": "Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP.",
    "questions": {
        "department": {
            "type": "choice",
            "instructions": "Which team should handle this?",
            "criteria": {
                "billing": "Payment or subscription issues",
                "technical": "Bugs or integration problems",
                "sales": "Pricing or account questions"
            }
        },
        "frustration": {
            "type": "score",
            "instructions": "How frustrated does the customer appear?",
            "criteria": ["Calm, just stating facts", "Frustrated but civil", "Very angry, strong language"]
        },
        "is_urgent": {
            "type": "noul",
            "instructions": "The message conveys urgency or time sensitivity."
        }
    }
}
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({
    model: 'd3-ultra',
    state: 'Hi, I\'ve been trying to connect my Stripe account for 3 days and it keeps failing. I\'m losing sales. Please help ASAP.',
    questions: {
      department: {
        type: 'choice',
        instructions: 'Which team should handle this?',
        criteria: {
          billing: 'Payment or subscription issues',
          technical: 'Bugs or integration problems',
          sales: 'Pricing or account questions'
        }
      },
      frustration: {
        type: 'score',
        instructions: 'How frustrated does the customer appear?',
        criteria: [
          'Calm, just stating facts',
          'Frustrated but civil',
          'Very angry, strong language'
        ]
      },
      is_urgent: {type: 'noul', instructions: 'The message conveys urgency or time sensitivity.'}
    }
  })
};

fetch('https://api.morphllm.com/v1/systemone', 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.morphllm.com/v1/systemone",
  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' => 'd3-ultra',
    'state' => 'Hi, I\'ve been trying to connect my Stripe account for 3 days and it keeps failing. I\'m losing sales. Please help ASAP.',
    'questions' => [
        'department' => [
                'type' => 'choice',
                'instructions' => 'Which team should handle this?',
                'criteria' => [
                                'billing' => 'Payment or subscription issues',
                                'technical' => 'Bugs or integration problems',
                                'sales' => 'Pricing or account questions'
                ]
        ],
        'frustration' => [
                'type' => 'score',
                'instructions' => 'How frustrated does the customer appear?',
                'criteria' => [
                                'Calm, just stating facts',
                                'Frustrated but civil',
                                'Very angry, strong language'
                ]
        ],
        'is_urgent' => [
                'type' => 'noul',
                'instructions' => 'The message conveys urgency or time sensitivity.'
        ]
    ]
  ]),
  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.morphllm.com/v1/systemone"

	payload := strings.NewReader("{\n  \"model\": \"d3-ultra\",\n  \"state\": \"Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP.\",\n  \"questions\": {\n    \"department\": {\n      \"type\": \"choice\",\n      \"instructions\": \"Which team should handle this?\",\n      \"criteria\": {\n        \"billing\": \"Payment or subscription issues\",\n        \"technical\": \"Bugs or integration problems\",\n        \"sales\": \"Pricing or account questions\"\n      }\n    },\n    \"frustration\": {\n      \"type\": \"score\",\n      \"instructions\": \"How frustrated does the customer appear?\",\n      \"criteria\": [\n        \"Calm, just stating facts\",\n        \"Frustrated but civil\",\n        \"Very angry, strong language\"\n      ]\n    },\n    \"is_urgent\": {\n      \"type\": \"noul\",\n      \"instructions\": \"The message conveys urgency or time sensitivity.\"\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.morphllm.com/v1/systemone")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"d3-ultra\",\n  \"state\": \"Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP.\",\n  \"questions\": {\n    \"department\": {\n      \"type\": \"choice\",\n      \"instructions\": \"Which team should handle this?\",\n      \"criteria\": {\n        \"billing\": \"Payment or subscription issues\",\n        \"technical\": \"Bugs or integration problems\",\n        \"sales\": \"Pricing or account questions\"\n      }\n    },\n    \"frustration\": {\n      \"type\": \"score\",\n      \"instructions\": \"How frustrated does the customer appear?\",\n      \"criteria\": [\n        \"Calm, just stating facts\",\n        \"Frustrated but civil\",\n        \"Very angry, strong language\"\n      ]\n    },\n    \"is_urgent\": {\n      \"type\": \"noul\",\n      \"instructions\": \"The message conveys urgency or time sensitivity.\"\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.morphllm.com/v1/systemone")

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\": \"d3-ultra\",\n  \"state\": \"Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP.\",\n  \"questions\": {\n    \"department\": {\n      \"type\": \"choice\",\n      \"instructions\": \"Which team should handle this?\",\n      \"criteria\": {\n        \"billing\": \"Payment or subscription issues\",\n        \"technical\": \"Bugs or integration problems\",\n        \"sales\": \"Pricing or account questions\"\n      }\n    },\n    \"frustration\": {\n      \"type\": \"score\",\n      \"instructions\": \"How frustrated does the customer appear?\",\n      \"criteria\": [\n        \"Calm, just stating facts\",\n        \"Frustrated but civil\",\n        \"Very angry, strong language\"\n      ]\n    },\n    \"is_urgent\": {\n      \"type\": \"noul\",\n      \"instructions\": \"The message conveys urgency or time sensitivity.\"\n    }\n  }\n}"

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

{
  "id": "dec-6f1c0b9e2a7d4c3e",
  "object": "structured_decision",
  "created": 1793577600,
  "model": "d3-ultra",
  "answers": {
    "department": {
      "type": "choice",
      "choice": "technical",
      "probabilities": {
        "billing": 0.21,
        "technical": 0.78,
        "sales": 0.01
      },
      "confidence": 0.77
    },
    "frustration": {
      "type": "score",
      "score": 1.3,
      "legend": {
        "0": "Calm, just stating facts",
        "1": "Frustrated but civil",
        "2": "Very angry, strong language"
      },
      "probabilities": {
        "0": 0,
        "1": 0.7,
        "2": 0.3
      },
      "confidence": 0.69
    },
    "is_urgent": {
      "type": "noul",
      "noul": 0.97,
      "probabilities": {
        "yes": 0.97,
        "no": 0.03
      },
      "confidence": 0.96
    }
  },
  "usage": {
    "input_tokens": 312,
    "output_tokens": 0,
    "input_tokens_details": {
      "cached_tokens": 256
    }
  },
  "diagnostics": {
    "department": {
      "label_mass": 0.99,
      "argmax_is_label": true
    },
    "frustration": {
      "label_mass": 0.99,
      "argmax_is_label": true
    },
    "is_urgent": {
      "label_mass": 0.99,
      "argmax_is_label": true
    }
  }
}

{
  "error": {
    "code": "invalid_request_error",
    "message": "The request body is missing the `model` field."
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key provided."
  }
}

{
  "error": {
    "message": "Unknown model 'gpt-5'; use one of ['d3-ultra'].",
    "type": "invalid_request_error",
    "param": "model",
    "code": "model_not_found"
  }
}

{
  "error": {
    "message": "`images` is not supported on this endpoint yet; send a text or JSON state.",
    "type": "invalid_request_error",
    "param": "images",
    "code": null
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Retry in 12 seconds."
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Something went wrong on our side."
  }
}

{
  "error": {
    "message": "The decision engine is unavailable.",
    "type": "api_error",
    "param": null,
    "code": null
  }
}

Get Started

Models

API Reference

Integrations

Overview

Writing questions

Reading answers

Pricing

Errors

Switching from another typed-decision API

Authorizations

Body

Response

​Overview

​Writing questions

​Reading answers

​Pricing

​Errors

​Switching from another typed-decision API

Authorizations

Body

Response

Overview

Writing questions

Reading answers

Pricing

Errors

Switching from another typed-decision API