Register a decision's version
curl --request POST \
--url https://api.moonbounce.ai/v1/decisions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"decision_id": "refund-exception",
"structure": {
"questions": {
"item_used": {
"type": "noul",
"instructions": "Has the customer used the item beyond trying it on or setting it up once?",
"reads": [
"state.message"
]
},
"defective": {
"type": "noul",
"instructions": "Does the customer describe a defect, damage on arrival, or the item failing under normal use?",
"reads": [
"state.message"
]
}
},
"attributes": {
"days_since_delivery": {
"type": "number",
"minimum": 0
}
},
"aggregations": {
"grant_score": {
"type": "weighted_mean",
"inputs": [
{
"name": "questions.item_used",
"invert": true
},
{
"name": "questions.defective"
}
]
},
"handling": {
"type": "rules",
"rules": [
{
"when": {
"name": "attributes.days_since_delivery",
"gt": 30
},
"outcome": "escalate"
},
{
"when": {
"name": "aggregations.grant_score",
"gte": 0.72
},
"outcome": "grant"
},
{
"when": {
"name": "aggregations.grant_score",
"lt": 0.38
},
"outcome": "deny"
}
],
"else": "escalate"
}
},
"result": "aggregations.handling"
},
"objective": {
"fallback": "escalate",
"mistakes": [
{
"expected": "deny",
"got": "grant",
"severity": "costly"
}
]
}
}
'import requests
url = "https://api.moonbounce.ai/v1/decisions"
payload = {
"decision_id": "refund-exception",
"structure": {
"questions": {
"item_used": {
"type": "noul",
"instructions": "Has the customer used the item beyond trying it on or setting it up once?",
"reads": ["state.message"]
},
"defective": {
"type": "noul",
"instructions": "Does the customer describe a defect, damage on arrival, or the item failing under normal use?",
"reads": ["state.message"]
}
},
"attributes": { "days_since_delivery": {
"type": "number",
"minimum": 0
} },
"aggregations": {
"grant_score": {
"type": "weighted_mean",
"inputs": [{
"name": "questions.item_used",
"invert": True
}, { "name": "questions.defective" }]
},
"handling": {
"type": "rules",
"rules": [
{
"when": {
"name": "attributes.days_since_delivery",
"gt": 30
},
"outcome": "escalate"
},
{
"when": {
"name": "aggregations.grant_score",
"gte": 0.72
},
"outcome": "grant"
},
{
"when": {
"name": "aggregations.grant_score",
"lt": 0.38
},
"outcome": "deny"
}
],
"else": "escalate"
}
},
"result": "aggregations.handling"
},
"objective": {
"fallback": "escalate",
"mistakes": [
{
"expected": "deny",
"got": "grant",
"severity": "costly"
}
]
}
}
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({
decision_id: 'refund-exception',
structure: {
questions: {
item_used: {
type: 'noul',
instructions: 'Has the customer used the item beyond trying it on or setting it up once?',
reads: ['state.message']
},
defective: {
type: 'noul',
instructions: 'Does the customer describe a defect, damage on arrival, or the item failing under normal use?',
reads: ['state.message']
}
},
attributes: {days_since_delivery: {type: 'number', minimum: 0}},
aggregations: {
grant_score: {
type: 'weighted_mean',
inputs: [{name: 'questions.item_used', invert: true}, {name: 'questions.defective'}]
},
handling: {
type: 'rules',
rules: [
{when: {name: 'attributes.days_since_delivery', gt: 30}, outcome: 'escalate'},
{when: {name: 'aggregations.grant_score', gte: 0.72}, outcome: 'grant'},
{when: {name: 'aggregations.grant_score', lt: 0.38}, outcome: 'deny'}
],
else: 'escalate'
}
},
result: 'aggregations.handling'
},
objective: {
fallback: 'escalate',
mistakes: [{expected: 'deny', got: 'grant', severity: 'costly'}]
}
})
};
fetch('https://api.moonbounce.ai/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.moonbounce.ai/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([
'decision_id' => 'refund-exception',
'structure' => [
'questions' => [
'item_used' => [
'type' => 'noul',
'instructions' => 'Has the customer used the item beyond trying it on or setting it up once?',
'reads' => [
'state.message'
]
],
'defective' => [
'type' => 'noul',
'instructions' => 'Does the customer describe a defect, damage on arrival, or the item failing under normal use?',
'reads' => [
'state.message'
]
]
],
'attributes' => [
'days_since_delivery' => [
'type' => 'number',
'minimum' => 0
]
],
'aggregations' => [
'grant_score' => [
'type' => 'weighted_mean',
'inputs' => [
[
'name' => 'questions.item_used',
'invert' => true
],
[
'name' => 'questions.defective'
]
]
],
'handling' => [
'type' => 'rules',
'rules' => [
[
'when' => [
'name' => 'attributes.days_since_delivery',
'gt' => 30
],
'outcome' => 'escalate'
],
[
'when' => [
'name' => 'aggregations.grant_score',
'gte' => 0.72
],
'outcome' => 'grant'
],
[
'when' => [
'name' => 'aggregations.grant_score',
'lt' => 0.38
],
'outcome' => 'deny'
]
],
'else' => 'escalate'
]
],
'result' => 'aggregations.handling'
],
'objective' => [
'fallback' => 'escalate',
'mistakes' => [
[
'expected' => 'deny',
'got' => 'grant',
'severity' => 'costly'
]
]
]
]),
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.moonbounce.ai/v1/decisions"
payload := strings.NewReader("{\n \"decision_id\": \"refund-exception\",\n \"structure\": {\n \"questions\": {\n \"item_used\": {\n \"type\": \"noul\",\n \"instructions\": \"Has the customer used the item beyond trying it on or setting it up once?\",\n \"reads\": [\n \"state.message\"\n ]\n },\n \"defective\": {\n \"type\": \"noul\",\n \"instructions\": \"Does the customer describe a defect, damage on arrival, or the item failing under normal use?\",\n \"reads\": [\n \"state.message\"\n ]\n }\n },\n \"attributes\": {\n \"days_since_delivery\": {\n \"type\": \"number\",\n \"minimum\": 0\n }\n },\n \"aggregations\": {\n \"grant_score\": {\n \"type\": \"weighted_mean\",\n \"inputs\": [\n {\n \"name\": \"questions.item_used\",\n \"invert\": true\n },\n {\n \"name\": \"questions.defective\"\n }\n ]\n },\n \"handling\": {\n \"type\": \"rules\",\n \"rules\": [\n {\n \"when\": {\n \"name\": \"attributes.days_since_delivery\",\n \"gt\": 30\n },\n \"outcome\": \"escalate\"\n },\n {\n \"when\": {\n \"name\": \"aggregations.grant_score\",\n \"gte\": 0.72\n },\n \"outcome\": \"grant\"\n },\n {\n \"when\": {\n \"name\": \"aggregations.grant_score\",\n \"lt\": 0.38\n },\n \"outcome\": \"deny\"\n }\n ],\n \"else\": \"escalate\"\n }\n },\n \"result\": \"aggregations.handling\"\n },\n \"objective\": {\n \"fallback\": \"escalate\",\n \"mistakes\": [\n {\n \"expected\": \"deny\",\n \"got\": \"grant\",\n \"severity\": \"costly\"\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.moonbounce.ai/v1/decisions")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"decision_id\": \"refund-exception\",\n \"structure\": {\n \"questions\": {\n \"item_used\": {\n \"type\": \"noul\",\n \"instructions\": \"Has the customer used the item beyond trying it on or setting it up once?\",\n \"reads\": [\n \"state.message\"\n ]\n },\n \"defective\": {\n \"type\": \"noul\",\n \"instructions\": \"Does the customer describe a defect, damage on arrival, or the item failing under normal use?\",\n \"reads\": [\n \"state.message\"\n ]\n }\n },\n \"attributes\": {\n \"days_since_delivery\": {\n \"type\": \"number\",\n \"minimum\": 0\n }\n },\n \"aggregations\": {\n \"grant_score\": {\n \"type\": \"weighted_mean\",\n \"inputs\": [\n {\n \"name\": \"questions.item_used\",\n \"invert\": true\n },\n {\n \"name\": \"questions.defective\"\n }\n ]\n },\n \"handling\": {\n \"type\": \"rules\",\n \"rules\": [\n {\n \"when\": {\n \"name\": \"attributes.days_since_delivery\",\n \"gt\": 30\n },\n \"outcome\": \"escalate\"\n },\n {\n \"when\": {\n \"name\": \"aggregations.grant_score\",\n \"gte\": 0.72\n },\n \"outcome\": \"grant\"\n },\n {\n \"when\": {\n \"name\": \"aggregations.grant_score\",\n \"lt\": 0.38\n },\n \"outcome\": \"deny\"\n }\n ],\n \"else\": \"escalate\"\n }\n },\n \"result\": \"aggregations.handling\"\n },\n \"objective\": {\n \"fallback\": \"escalate\",\n \"mistakes\": [\n {\n \"expected\": \"deny\",\n \"got\": \"grant\",\n \"severity\": \"costly\"\n }\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.moonbounce.ai/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 \"decision_id\": \"refund-exception\",\n \"structure\": {\n \"questions\": {\n \"item_used\": {\n \"type\": \"noul\",\n \"instructions\": \"Has the customer used the item beyond trying it on or setting it up once?\",\n \"reads\": [\n \"state.message\"\n ]\n },\n \"defective\": {\n \"type\": \"noul\",\n \"instructions\": \"Does the customer describe a defect, damage on arrival, or the item failing under normal use?\",\n \"reads\": [\n \"state.message\"\n ]\n }\n },\n \"attributes\": {\n \"days_since_delivery\": {\n \"type\": \"number\",\n \"minimum\": 0\n }\n },\n \"aggregations\": {\n \"grant_score\": {\n \"type\": \"weighted_mean\",\n \"inputs\": [\n {\n \"name\": \"questions.item_used\",\n \"invert\": true\n },\n {\n \"name\": \"questions.defective\"\n }\n ]\n },\n \"handling\": {\n \"type\": \"rules\",\n \"rules\": [\n {\n \"when\": {\n \"name\": \"attributes.days_since_delivery\",\n \"gt\": 30\n },\n \"outcome\": \"escalate\"\n },\n {\n \"when\": {\n \"name\": \"aggregations.grant_score\",\n \"gte\": 0.72\n },\n \"outcome\": \"grant\"\n },\n {\n \"when\": {\n \"name\": \"aggregations.grant_score\",\n \"lt\": 0.38\n },\n \"outcome\": \"deny\"\n }\n ],\n \"else\": \"escalate\"\n }\n },\n \"result\": \"aggregations.handling\"\n },\n \"objective\": {\n \"fallback\": \"escalate\",\n \"mistakes\": [\n {\n \"expected\": \"deny\",\n \"got\": \"grant\",\n \"severity\": \"costly\"\n }\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"decision_id": "refund-exception",
"version": {
"structure_hash": "sha256:bdad6e5b1b879209305f1555b43ec62666a4d74a925280c66e54cc4dc07bb1ae",
"number": 1,
"question_hashes": {
"item_used": "sha256:2cd936709034818c3beca2574ca48ef400577728a20532924ed68f1ca1f26e3d",
"defective": "sha256:8dd4a69d6bfaf9fa766adcac7cfa1c4af7eff57a690a1e39666398bf85cd1869"
},
"created_at": "2026-11-06T09:00:00.000Z"
},
"created": false,
"objective": {
"revision": 1,
"created": false
}
}{
"decision_id": "refund-exception",
"version": {
"structure_hash": "sha256:bdad6e5b1b879209305f1555b43ec62666a4d74a925280c66e54cc4dc07bb1ae",
"number": 1,
"question_hashes": {
"item_used": "sha256:2cd936709034818c3beca2574ca48ef400577728a20532924ed68f1ca1f26e3d",
"defective": "sha256:8dd4a69d6bfaf9fa766adcac7cfa1c4af7eff57a690a1e39666398bf85cd1869"
},
"created_at": "2026-11-06T09:00:00.000Z"
},
"created": true,
"objective": {
"revision": 1,
"created": true
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"reason": "<string>",
"param": "<string>",
"details": {
"issues": [
{
"param": "<string>",
"code": "<string>",
"message": "<string>"
}
]
}
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"reason": "<string>",
"param": "<string>",
"details": {
"issues": [
{
"param": "<string>",
"code": "<string>",
"message": "<string>"
}
]
}
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"reason": "<string>",
"param": "<string>",
"details": {
"issues": [
{
"param": "<string>",
"code": "<string>",
"message": "<string>"
}
]
}
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"reason": "<string>",
"param": "<string>",
"details": {
"issues": [
{
"param": "<string>",
"code": "<string>",
"message": "<string>"
}
]
}
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"reason": "<string>",
"param": "<string>",
"details": {
"issues": [
{
"param": "<string>",
"code": "<string>",
"message": "<string>"
}
]
}
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"reason": "<string>",
"param": "<string>",
"details": {
"issues": [
{
"param": "<string>",
"code": "<string>",
"message": "<string>"
}
]
}
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"reason": "<string>",
"param": "<string>",
"details": {
"issues": [
{
"param": "<string>",
"code": "<string>",
"message": "<string>"
}
]
}
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"reason": "<string>",
"param": "<string>",
"details": {
"issues": [
{
"param": "<string>",
"code": "<string>",
"message": "<string>"
}
]
}
}
}decisions
Register a decision's version
Takes the decision file ({decision_id, structure, objective?}) and registers its structure as the decision’s next version, creating the decision if the id is new. Idempotent by content: 201 when this call added the version, 200 when that structure hash was already registered for the decision. On the first registration, created is true and version.number is 1. Evaluations can then name the version by structure_hash. Decisions and versions belong to the whole organization, so a test key and a production key see the same ones. objective: absent leaves the stored objective as it is; null clears it; an objective is stored as a new revision in the key’s environment when it differs from the current one, in the same transaction as the version. The file is the unit: its objective’s outcomes are checked against the body’s structure, and one that structure can’t produce is a 400 that writes nothing. That holds when the body re-registers an older version too, while getObjective and setObjective report unknown_outcomes against the newest version, so an objective stored that way can list some there. Returns hashes without the structure; getVersion reads it back. An Idempotency-Key covers the body as sent.
POST
/
v1
/
decisions
Register a decision's version
curl --request POST \
--url https://api.moonbounce.ai/v1/decisions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"decision_id": "refund-exception",
"structure": {
"questions": {
"item_used": {
"type": "noul",
"instructions": "Has the customer used the item beyond trying it on or setting it up once?",
"reads": [
"state.message"
]
},
"defective": {
"type": "noul",
"instructions": "Does the customer describe a defect, damage on arrival, or the item failing under normal use?",
"reads": [
"state.message"
]
}
},
"attributes": {
"days_since_delivery": {
"type": "number",
"minimum": 0
}
},
"aggregations": {
"grant_score": {
"type": "weighted_mean",
"inputs": [
{
"name": "questions.item_used",
"invert": true
},
{
"name": "questions.defective"
}
]
},
"handling": {
"type": "rules",
"rules": [
{
"when": {
"name": "attributes.days_since_delivery",
"gt": 30
},
"outcome": "escalate"
},
{
"when": {
"name": "aggregations.grant_score",
"gte": 0.72
},
"outcome": "grant"
},
{
"when": {
"name": "aggregations.grant_score",
"lt": 0.38
},
"outcome": "deny"
}
],
"else": "escalate"
}
},
"result": "aggregations.handling"
},
"objective": {
"fallback": "escalate",
"mistakes": [
{
"expected": "deny",
"got": "grant",
"severity": "costly"
}
]
}
}
'import requests
url = "https://api.moonbounce.ai/v1/decisions"
payload = {
"decision_id": "refund-exception",
"structure": {
"questions": {
"item_used": {
"type": "noul",
"instructions": "Has the customer used the item beyond trying it on or setting it up once?",
"reads": ["state.message"]
},
"defective": {
"type": "noul",
"instructions": "Does the customer describe a defect, damage on arrival, or the item failing under normal use?",
"reads": ["state.message"]
}
},
"attributes": { "days_since_delivery": {
"type": "number",
"minimum": 0
} },
"aggregations": {
"grant_score": {
"type": "weighted_mean",
"inputs": [{
"name": "questions.item_used",
"invert": True
}, { "name": "questions.defective" }]
},
"handling": {
"type": "rules",
"rules": [
{
"when": {
"name": "attributes.days_since_delivery",
"gt": 30
},
"outcome": "escalate"
},
{
"when": {
"name": "aggregations.grant_score",
"gte": 0.72
},
"outcome": "grant"
},
{
"when": {
"name": "aggregations.grant_score",
"lt": 0.38
},
"outcome": "deny"
}
],
"else": "escalate"
}
},
"result": "aggregations.handling"
},
"objective": {
"fallback": "escalate",
"mistakes": [
{
"expected": "deny",
"got": "grant",
"severity": "costly"
}
]
}
}
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({
decision_id: 'refund-exception',
structure: {
questions: {
item_used: {
type: 'noul',
instructions: 'Has the customer used the item beyond trying it on or setting it up once?',
reads: ['state.message']
},
defective: {
type: 'noul',
instructions: 'Does the customer describe a defect, damage on arrival, or the item failing under normal use?',
reads: ['state.message']
}
},
attributes: {days_since_delivery: {type: 'number', minimum: 0}},
aggregations: {
grant_score: {
type: 'weighted_mean',
inputs: [{name: 'questions.item_used', invert: true}, {name: 'questions.defective'}]
},
handling: {
type: 'rules',
rules: [
{when: {name: 'attributes.days_since_delivery', gt: 30}, outcome: 'escalate'},
{when: {name: 'aggregations.grant_score', gte: 0.72}, outcome: 'grant'},
{when: {name: 'aggregations.grant_score', lt: 0.38}, outcome: 'deny'}
],
else: 'escalate'
}
},
result: 'aggregations.handling'
},
objective: {
fallback: 'escalate',
mistakes: [{expected: 'deny', got: 'grant', severity: 'costly'}]
}
})
};
fetch('https://api.moonbounce.ai/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.moonbounce.ai/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([
'decision_id' => 'refund-exception',
'structure' => [
'questions' => [
'item_used' => [
'type' => 'noul',
'instructions' => 'Has the customer used the item beyond trying it on or setting it up once?',
'reads' => [
'state.message'
]
],
'defective' => [
'type' => 'noul',
'instructions' => 'Does the customer describe a defect, damage on arrival, or the item failing under normal use?',
'reads' => [
'state.message'
]
]
],
'attributes' => [
'days_since_delivery' => [
'type' => 'number',
'minimum' => 0
]
],
'aggregations' => [
'grant_score' => [
'type' => 'weighted_mean',
'inputs' => [
[
'name' => 'questions.item_used',
'invert' => true
],
[
'name' => 'questions.defective'
]
]
],
'handling' => [
'type' => 'rules',
'rules' => [
[
'when' => [
'name' => 'attributes.days_since_delivery',
'gt' => 30
],
'outcome' => 'escalate'
],
[
'when' => [
'name' => 'aggregations.grant_score',
'gte' => 0.72
],
'outcome' => 'grant'
],
[
'when' => [
'name' => 'aggregations.grant_score',
'lt' => 0.38
],
'outcome' => 'deny'
]
],
'else' => 'escalate'
]
],
'result' => 'aggregations.handling'
],
'objective' => [
'fallback' => 'escalate',
'mistakes' => [
[
'expected' => 'deny',
'got' => 'grant',
'severity' => 'costly'
]
]
]
]),
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.moonbounce.ai/v1/decisions"
payload := strings.NewReader("{\n \"decision_id\": \"refund-exception\",\n \"structure\": {\n \"questions\": {\n \"item_used\": {\n \"type\": \"noul\",\n \"instructions\": \"Has the customer used the item beyond trying it on or setting it up once?\",\n \"reads\": [\n \"state.message\"\n ]\n },\n \"defective\": {\n \"type\": \"noul\",\n \"instructions\": \"Does the customer describe a defect, damage on arrival, or the item failing under normal use?\",\n \"reads\": [\n \"state.message\"\n ]\n }\n },\n \"attributes\": {\n \"days_since_delivery\": {\n \"type\": \"number\",\n \"minimum\": 0\n }\n },\n \"aggregations\": {\n \"grant_score\": {\n \"type\": \"weighted_mean\",\n \"inputs\": [\n {\n \"name\": \"questions.item_used\",\n \"invert\": true\n },\n {\n \"name\": \"questions.defective\"\n }\n ]\n },\n \"handling\": {\n \"type\": \"rules\",\n \"rules\": [\n {\n \"when\": {\n \"name\": \"attributes.days_since_delivery\",\n \"gt\": 30\n },\n \"outcome\": \"escalate\"\n },\n {\n \"when\": {\n \"name\": \"aggregations.grant_score\",\n \"gte\": 0.72\n },\n \"outcome\": \"grant\"\n },\n {\n \"when\": {\n \"name\": \"aggregations.grant_score\",\n \"lt\": 0.38\n },\n \"outcome\": \"deny\"\n }\n ],\n \"else\": \"escalate\"\n }\n },\n \"result\": \"aggregations.handling\"\n },\n \"objective\": {\n \"fallback\": \"escalate\",\n \"mistakes\": [\n {\n \"expected\": \"deny\",\n \"got\": \"grant\",\n \"severity\": \"costly\"\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.moonbounce.ai/v1/decisions")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"decision_id\": \"refund-exception\",\n \"structure\": {\n \"questions\": {\n \"item_used\": {\n \"type\": \"noul\",\n \"instructions\": \"Has the customer used the item beyond trying it on or setting it up once?\",\n \"reads\": [\n \"state.message\"\n ]\n },\n \"defective\": {\n \"type\": \"noul\",\n \"instructions\": \"Does the customer describe a defect, damage on arrival, or the item failing under normal use?\",\n \"reads\": [\n \"state.message\"\n ]\n }\n },\n \"attributes\": {\n \"days_since_delivery\": {\n \"type\": \"number\",\n \"minimum\": 0\n }\n },\n \"aggregations\": {\n \"grant_score\": {\n \"type\": \"weighted_mean\",\n \"inputs\": [\n {\n \"name\": \"questions.item_used\",\n \"invert\": true\n },\n {\n \"name\": \"questions.defective\"\n }\n ]\n },\n \"handling\": {\n \"type\": \"rules\",\n \"rules\": [\n {\n \"when\": {\n \"name\": \"attributes.days_since_delivery\",\n \"gt\": 30\n },\n \"outcome\": \"escalate\"\n },\n {\n \"when\": {\n \"name\": \"aggregations.grant_score\",\n \"gte\": 0.72\n },\n \"outcome\": \"grant\"\n },\n {\n \"when\": {\n \"name\": \"aggregations.grant_score\",\n \"lt\": 0.38\n },\n \"outcome\": \"deny\"\n }\n ],\n \"else\": \"escalate\"\n }\n },\n \"result\": \"aggregations.handling\"\n },\n \"objective\": {\n \"fallback\": \"escalate\",\n \"mistakes\": [\n {\n \"expected\": \"deny\",\n \"got\": \"grant\",\n \"severity\": \"costly\"\n }\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.moonbounce.ai/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 \"decision_id\": \"refund-exception\",\n \"structure\": {\n \"questions\": {\n \"item_used\": {\n \"type\": \"noul\",\n \"instructions\": \"Has the customer used the item beyond trying it on or setting it up once?\",\n \"reads\": [\n \"state.message\"\n ]\n },\n \"defective\": {\n \"type\": \"noul\",\n \"instructions\": \"Does the customer describe a defect, damage on arrival, or the item failing under normal use?\",\n \"reads\": [\n \"state.message\"\n ]\n }\n },\n \"attributes\": {\n \"days_since_delivery\": {\n \"type\": \"number\",\n \"minimum\": 0\n }\n },\n \"aggregations\": {\n \"grant_score\": {\n \"type\": \"weighted_mean\",\n \"inputs\": [\n {\n \"name\": \"questions.item_used\",\n \"invert\": true\n },\n {\n \"name\": \"questions.defective\"\n }\n ]\n },\n \"handling\": {\n \"type\": \"rules\",\n \"rules\": [\n {\n \"when\": {\n \"name\": \"attributes.days_since_delivery\",\n \"gt\": 30\n },\n \"outcome\": \"escalate\"\n },\n {\n \"when\": {\n \"name\": \"aggregations.grant_score\",\n \"gte\": 0.72\n },\n \"outcome\": \"grant\"\n },\n {\n \"when\": {\n \"name\": \"aggregations.grant_score\",\n \"lt\": 0.38\n },\n \"outcome\": \"deny\"\n }\n ],\n \"else\": \"escalate\"\n }\n },\n \"result\": \"aggregations.handling\"\n },\n \"objective\": {\n \"fallback\": \"escalate\",\n \"mistakes\": [\n {\n \"expected\": \"deny\",\n \"got\": \"grant\",\n \"severity\": \"costly\"\n }\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"decision_id": "refund-exception",
"version": {
"structure_hash": "sha256:bdad6e5b1b879209305f1555b43ec62666a4d74a925280c66e54cc4dc07bb1ae",
"number": 1,
"question_hashes": {
"item_used": "sha256:2cd936709034818c3beca2574ca48ef400577728a20532924ed68f1ca1f26e3d",
"defective": "sha256:8dd4a69d6bfaf9fa766adcac7cfa1c4af7eff57a690a1e39666398bf85cd1869"
},
"created_at": "2026-11-06T09:00:00.000Z"
},
"created": false,
"objective": {
"revision": 1,
"created": false
}
}{
"decision_id": "refund-exception",
"version": {
"structure_hash": "sha256:bdad6e5b1b879209305f1555b43ec62666a4d74a925280c66e54cc4dc07bb1ae",
"number": 1,
"question_hashes": {
"item_used": "sha256:2cd936709034818c3beca2574ca48ef400577728a20532924ed68f1ca1f26e3d",
"defective": "sha256:8dd4a69d6bfaf9fa766adcac7cfa1c4af7eff57a690a1e39666398bf85cd1869"
},
"created_at": "2026-11-06T09:00:00.000Z"
},
"created": true,
"objective": {
"revision": 1,
"created": true
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"reason": "<string>",
"param": "<string>",
"details": {
"issues": [
{
"param": "<string>",
"code": "<string>",
"message": "<string>"
}
]
}
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"reason": "<string>",
"param": "<string>",
"details": {
"issues": [
{
"param": "<string>",
"code": "<string>",
"message": "<string>"
}
]
}
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"reason": "<string>",
"param": "<string>",
"details": {
"issues": [
{
"param": "<string>",
"code": "<string>",
"message": "<string>"
}
]
}
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"reason": "<string>",
"param": "<string>",
"details": {
"issues": [
{
"param": "<string>",
"code": "<string>",
"message": "<string>"
}
]
}
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"reason": "<string>",
"param": "<string>",
"details": {
"issues": [
{
"param": "<string>",
"code": "<string>",
"message": "<string>"
}
]
}
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"reason": "<string>",
"param": "<string>",
"details": {
"issues": [
{
"param": "<string>",
"code": "<string>",
"message": "<string>"
}
]
}
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"reason": "<string>",
"param": "<string>",
"details": {
"issues": [
{
"param": "<string>",
"code": "<string>",
"message": "<string>"
}
]
}
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"reason": "<string>",
"param": "<string>",
"details": {
"issues": [
{
"param": "<string>",
"code": "<string>",
"message": "<string>"
}
]
}
}
}Authorizations
An API key, sent as Authorization: Bearer <key>. Each operation lists the scope its key needs: decisions:evaluate (evaluate and read evaluations), decisions:feedback (your app's feedback) or decisions:develop (everything else, including owner feedback and the review queue). An operation listing no scope takes any scoped key. A key with no scope, or without the operation's, gets 403 INSUFFICIENT_SCOPE.
Headers
Makes a retry safe. For 24 hours, the same key with the same request returns the first stored result (with Idempotent-Replayed: true); the same key with a different request is a 422 IDEMPOTENCY_KEY_REUSED. Keys are scoped to the organization and environment across every operation, so use a fresh key per request. A request that failed before its result was stored runs again when retried with its key.
Required string length:
1 - 255Pattern:
^[\x20-\x7e]+$Body
application/json
The decision file your repository keeps (moonbounce/<decision_id>.json).
A name you choose for this decision, such as refund-exception: a lowercase letter, then up to 127 of a-z 0-9 _ . -. Unique in your organization and shared by its test and production keys. The first registration or evaluation under a new one creates the decision.
Pattern:
^[a-z][a-z0-9_.-]{0,127}$Everything that defines a decision: questions, attribute declarations, aggregations and the result. Names are unique across all three maps.
Show child attributes
Show child attributes
What the decision optimizes for, stored for the key's environment. Absent: the stored objective is left as it is. null: cleared, back to balanced losses. An objective: stored as a new revision when it differs from the current one. Its outcomes must be ones this body's structure can produce (400 otherwise), even when that structure is an older version; getObjective checks the stored one against the newest version. Never part of the structure hash.
Show child attributes
Show child attributes
Response
The version was already registered
A name you choose for this decision, such as refund-exception: a lowercase letter, then up to 127 of a-z 0-9 _ . -. Unique in your organization and shared by its test and production keys. The first registration or evaluation under a new one creates the decision.
Pattern:
^[a-z][a-z0-9_.-]{0,127}$A registered structure: its hash, its number under the decision and each question's hash.
Show child attributes
Show child attributes
True when this call registered the version, false when it already existed.
Present only when the body had an objective key.
Show child attributes
Show child attributes