Decisions
Run decisions
Score fixed outcomes for each decision against one shared context. Inspect each result’s probabilities and policy before acting, and check the returned model and fallback details. Scores are normalized across the outcomes you supply; they are not a guarantee that the selected outcome is correct.
Reuse an Idempotency-Key and identical body after a lost response. The original operation is replayed without executing or charging again. Responses are retained for 24 hours; afterward the same key returns an expired-response error. An organisation with zero data retention keeps no response, so a retry runs again and is charged again.
The response example is a historical pilot recording from 26 September 2026; its model, timing and probabilities describe that run.
POST
/
v1
/
decide
Run decisions
curl --request POST \
--url https://api.sqwish.ai/v1/decide \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"model": "kettei-core",
"context": "Our billing export has failed for two days. We need it for today's audit.",
"decisions": [
{
"id": "team",
"kind": "single",
"question": "Which team should handle this ticket?",
"outcomes": {
"billing": "Charges, invoices, and financial exports.",
"technical": "Other application failures.",
"sales": "New purchases."
}
},
{
"id": "urgent",
"kind": "binary",
"question": "Does the ticket state a deadline within one day?",
"outcomes": {
"yes": "An explicit deadline is today or within the next 24 hours.",
"no": "The deadline is later, absent, or unclear."
}
},
{
"id": "impact",
"kind": "ordinal",
"question": "How severe is the reported impact on the customer's work?",
"outcomes": [
"0",
"1",
"2"
],
"rubric": [
"Minor inconvenience; the task can still be completed.",
"The task is impaired, but a workable alternative is stated.",
"An important task is blocked and no workable alternative is stated."
]
}
]
}
EOFimport requests
url = "https://api.sqwish.ai/v1/decide"
payload = {
"model": "kettei-core",
"context": "Our billing export has failed for two days. We need it for today's audit.",
"decisions": [
{
"id": "team",
"kind": "single",
"question": "Which team should handle this ticket?",
"outcomes": {
"billing": "Charges, invoices, and financial exports.",
"technical": "Other application failures.",
"sales": "New purchases."
}
},
{
"id": "urgent",
"kind": "binary",
"question": "Does the ticket state a deadline within one day?",
"outcomes": {
"yes": "An explicit deadline is today or within the next 24 hours.",
"no": "The deadline is later, absent, or unclear."
}
},
{
"id": "impact",
"kind": "ordinal",
"question": "How severe is the reported impact on the customer's work?",
"outcomes": ["0", "1", "2"],
"rubric": ["Minor inconvenience; the task can still be completed.", "The task is impaired, but a workable alternative is stated.", "An important task is blocked and no workable alternative is stated."]
}
]
}
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: 'kettei-core',
context: 'Our billing export has failed for two days. We need it for today\'s audit.',
decisions: [
{
id: 'team',
kind: 'single',
question: 'Which team should handle this ticket?',
outcomes: {
billing: 'Charges, invoices, and financial exports.',
technical: 'Other application failures.',
sales: 'New purchases.'
}
},
{
id: 'urgent',
kind: 'binary',
question: 'Does the ticket state a deadline within one day?',
outcomes: {
yes: 'An explicit deadline is today or within the next 24 hours.',
no: 'The deadline is later, absent, or unclear.'
}
},
{
id: 'impact',
kind: 'ordinal',
question: 'How severe is the reported impact on the customer\'s work?',
outcomes: ['0', '1', '2'],
rubric: [
'Minor inconvenience; the task can still be completed.',
'The task is impaired, but a workable alternative is stated.',
'An important task is blocked and no workable alternative is stated.'
]
}
]
})
};
fetch('https://api.sqwish.ai/v1/decide', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "dec_963b7180cbd24e69a09870f8",
"model": "kettei-core",
"decisions": {
"team": {
"kind": "single",
"probabilities": {
"billing": 0.9268172836638902,
"technical": 0.05394723671050278,
"sales": 0.019235479625606948
},
"top": "billing",
"p_top": 0.9268172836638902
},
"urgent": {
"kind": "binary",
"probabilities": {
"yes": 0.9124361664296878,
"no": 0.08756383357031215
},
"top": "yes",
"p_top": 0.9124361664296878
},
"impact": {
"kind": "ordinal",
"probabilities": {
"0": 0.05066966056527368,
"1": 0.105604641144301,
"2": 0.8437256982904253
},
"top": "2",
"p_top": 0.8437256982904253,
"expected_level": 1.7930560377251517
}
},
"usage": {
"input_tokens": 648,
"decisions": 3,
"tokenizer": {
"name": "nvidia/NVIDIA-Nemotron-3.5-Lightning-30B-A3B-BF16",
"revision": "a9904d24bcc1d289a1950fa9d2b978c47cf903b9"
}
},
"timing_ms": {
"render": 3.829091787338257,
"score": 221.20973281562328
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"request_id": "<string>",
"details": [
{
"path": [
"<string>"
],
"message": "<string>",
"type": "<string>"
}
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"request_id": "<string>",
"details": [
{
"path": [
"<string>"
],
"message": "<string>",
"type": "<string>"
}
]
}
}Headers
Reuse the same key and body after a lost response. A successful replay does not execute or charge again. Changed request bodies conflict; expired replay bodies are not executed again under the old key. An organisation with zero data retention keeps no answer, so its key is not honoured: a retry runs again and is charged again.
Required string length:
1 - 255Pattern:
^[!-~]+$Body
application/json
Up to 8 images the decisions are about, each shown where the context says <image:id>. The context must then be a string with an anchor for each image. fat and chub (kettei-fat, kettei-chub) read images; other models refuse them with images_not_supported. The model reads at most 2,097,152 pixels of an image, so one with more only takes longer to upload: shrink each to fit, and send a photo as JPEG.
Required array length:
1 - 8 elementsShow child attributes
Show child attributes
The temperature T of every answer of this request: probabilities become p^(1/T), renormalised, so below 1 they are sharper and above 1 softer. The top answer never changes. Leave it out for the model's own default for each kind of decision; send 1 for the probabilities exactly as the engine scored them.
Required range:
0.2 <= x <= 5Response
One probability distribution for each decision.
The temperature T each decision's probabilities were given, p^(1/T) renormalised, for the decisions that have one: the request's own temperature, or the model's default for that kind of decision. Absent when every answer is as the engine scored it. The top answer never changes.
Show child attributes
Show child attributes
Run decisions
curl --request POST \
--url https://api.sqwish.ai/v1/decide \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"model": "kettei-core",
"context": "Our billing export has failed for two days. We need it for today's audit.",
"decisions": [
{
"id": "team",
"kind": "single",
"question": "Which team should handle this ticket?",
"outcomes": {
"billing": "Charges, invoices, and financial exports.",
"technical": "Other application failures.",
"sales": "New purchases."
}
},
{
"id": "urgent",
"kind": "binary",
"question": "Does the ticket state a deadline within one day?",
"outcomes": {
"yes": "An explicit deadline is today or within the next 24 hours.",
"no": "The deadline is later, absent, or unclear."
}
},
{
"id": "impact",
"kind": "ordinal",
"question": "How severe is the reported impact on the customer's work?",
"outcomes": [
"0",
"1",
"2"
],
"rubric": [
"Minor inconvenience; the task can still be completed.",
"The task is impaired, but a workable alternative is stated.",
"An important task is blocked and no workable alternative is stated."
]
}
]
}
EOFimport requests
url = "https://api.sqwish.ai/v1/decide"
payload = {
"model": "kettei-core",
"context": "Our billing export has failed for two days. We need it for today's audit.",
"decisions": [
{
"id": "team",
"kind": "single",
"question": "Which team should handle this ticket?",
"outcomes": {
"billing": "Charges, invoices, and financial exports.",
"technical": "Other application failures.",
"sales": "New purchases."
}
},
{
"id": "urgent",
"kind": "binary",
"question": "Does the ticket state a deadline within one day?",
"outcomes": {
"yes": "An explicit deadline is today or within the next 24 hours.",
"no": "The deadline is later, absent, or unclear."
}
},
{
"id": "impact",
"kind": "ordinal",
"question": "How severe is the reported impact on the customer's work?",
"outcomes": ["0", "1", "2"],
"rubric": ["Minor inconvenience; the task can still be completed.", "The task is impaired, but a workable alternative is stated.", "An important task is blocked and no workable alternative is stated."]
}
]
}
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: 'kettei-core',
context: 'Our billing export has failed for two days. We need it for today\'s audit.',
decisions: [
{
id: 'team',
kind: 'single',
question: 'Which team should handle this ticket?',
outcomes: {
billing: 'Charges, invoices, and financial exports.',
technical: 'Other application failures.',
sales: 'New purchases.'
}
},
{
id: 'urgent',
kind: 'binary',
question: 'Does the ticket state a deadline within one day?',
outcomes: {
yes: 'An explicit deadline is today or within the next 24 hours.',
no: 'The deadline is later, absent, or unclear.'
}
},
{
id: 'impact',
kind: 'ordinal',
question: 'How severe is the reported impact on the customer\'s work?',
outcomes: ['0', '1', '2'],
rubric: [
'Minor inconvenience; the task can still be completed.',
'The task is impaired, but a workable alternative is stated.',
'An important task is blocked and no workable alternative is stated.'
]
}
]
})
};
fetch('https://api.sqwish.ai/v1/decide', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "dec_963b7180cbd24e69a09870f8",
"model": "kettei-core",
"decisions": {
"team": {
"kind": "single",
"probabilities": {
"billing": 0.9268172836638902,
"technical": 0.05394723671050278,
"sales": 0.019235479625606948
},
"top": "billing",
"p_top": 0.9268172836638902
},
"urgent": {
"kind": "binary",
"probabilities": {
"yes": 0.9124361664296878,
"no": 0.08756383357031215
},
"top": "yes",
"p_top": 0.9124361664296878
},
"impact": {
"kind": "ordinal",
"probabilities": {
"0": 0.05066966056527368,
"1": 0.105604641144301,
"2": 0.8437256982904253
},
"top": "2",
"p_top": 0.8437256982904253,
"expected_level": 1.7930560377251517
}
},
"usage": {
"input_tokens": 648,
"decisions": 3,
"tokenizer": {
"name": "nvidia/NVIDIA-Nemotron-3.5-Lightning-30B-A3B-BF16",
"revision": "a9904d24bcc1d289a1950fa9d2b978c47cf903b9"
}
},
"timing_ms": {
"render": 3.829091787338257,
"score": 221.20973281562328
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"request_id": "<string>",
"details": [
{
"path": [
"<string>"
],
"message": "<string>",
"type": "<string>"
}
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"request_id": "<string>",
"details": [
{
"path": [
"<string>"
],
"message": "<string>",
"type": "<string>"
}
]
}
}