Validate a decision file
curl --request POST \
--url https://api.moonbounce.ai/v1/validate \
--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/validate"
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 = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'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/validate', 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/validate",
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 => [
"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/validate"
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("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/validate")
.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/validate")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
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{
"structure_hash": "sha256:bdad6e5b1b879209305f1555b43ec62666a4d74a925280c66e54cc4dc07bb1ae",
"question_hashes": {
"item_used": "sha256:2cd936709034818c3beca2574ca48ef400577728a20532924ed68f1ca1f26e3d",
"defective": "sha256:8dd4a69d6bfaf9fa766adcac7cfa1c4af7eff57a690a1e39666398bf85cd1869"
},
"canonical": "{\"aggregations\":{\"grant_score\":{\"inputs\":[{\"invert\":true,\"name\":\"questions.item_used\"},{\"name\":\"questions.defective\"}],\"type\":\"weighted_mean\"},\"handling\":{\"else\":\"escalate\",\"rules\":[{\"outcome\":\"escalate\",\"when\":{\"gt\":30,\"name\":\"attributes.days_since_delivery\"}},{\"outcome\":\"grant\",\"when\":{\"gte\":0.72,\"name\":\"aggregations.grant_score\"}},{\"outcome\":\"deny\",\"when\":{\"lt\":0.38,\"name\":\"aggregations.grant_score\"}}],\"type\":\"rules\"}},\"attributes\":{\"days_since_delivery\":{\"minimum\":0,\"type\":\"number\"}},\"format\":\"moonbounce.structure/1\",\"questions\":{\"defective\":{\"instructions\":\"Does the customer describe a defect, damage on arrival, or the item failing under normal use?\",\"reads\":[\"state.message\"],\"type\":\"noul\"},\"item_used\":{\"instructions\":\"Has the customer used the item beyond trying it on or setting it up once?\",\"reads\":[\"state.message\"],\"type\":\"noul\"}},\"result\":\"aggregations.handling\"}",
"warnings": []
}{
"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
Validate a decision file
Checks a decision file ({decision_id?, structure, objective?}) and returns its structure hash, every question’s hash, the canonical text the hash is the SHA-256 of, and warnings, without registering anything: free (no model call), public (needs no API key), and safe to run in CI on every change. An invalid file is a 400 whose details.issues lists every issue, each with its param, as registerDecision would answer; so is an objective naming an outcome the structure can’t produce. decision_id is optional and only checked against the id pattern. Warnings never depend on an environment or a model; UNUSED_FEATURE names a question, attribute or aggregation the result never reaches. Key order, Unicode normalization (NFC) of instructions, criteria and attribute sources, the order of reads and of aggregation inputs, and defaults spelled out (invert: false, gte: 0.5, empty criteria) do not change the hashes. Read paths, string attribute labels and label comparisons stay exact, since customer content is not normalized.
POST
/
v1
/
validate
Validate a decision file
curl --request POST \
--url https://api.moonbounce.ai/v1/validate \
--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/validate"
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 = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'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/validate', 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/validate",
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 => [
"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/validate"
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("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/validate")
.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/validate")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
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{
"structure_hash": "sha256:bdad6e5b1b879209305f1555b43ec62666a4d74a925280c66e54cc4dc07bb1ae",
"question_hashes": {
"item_used": "sha256:2cd936709034818c3beca2574ca48ef400577728a20532924ed68f1ca1f26e3d",
"defective": "sha256:8dd4a69d6bfaf9fa766adcac7cfa1c4af7eff57a690a1e39666398bf85cd1869"
},
"canonical": "{\"aggregations\":{\"grant_score\":{\"inputs\":[{\"invert\":true,\"name\":\"questions.item_used\"},{\"name\":\"questions.defective\"}],\"type\":\"weighted_mean\"},\"handling\":{\"else\":\"escalate\",\"rules\":[{\"outcome\":\"escalate\",\"when\":{\"gt\":30,\"name\":\"attributes.days_since_delivery\"}},{\"outcome\":\"grant\",\"when\":{\"gte\":0.72,\"name\":\"aggregations.grant_score\"}},{\"outcome\":\"deny\",\"when\":{\"lt\":0.38,\"name\":\"aggregations.grant_score\"}}],\"type\":\"rules\"}},\"attributes\":{\"days_since_delivery\":{\"minimum\":0,\"type\":\"number\"}},\"format\":\"moonbounce.structure/1\",\"questions\":{\"defective\":{\"instructions\":\"Does the customer describe a defect, damage on arrival, or the item failing under normal use?\",\"reads\":[\"state.message\"],\"type\":\"noul\"},\"item_used\":{\"instructions\":\"Has the customer used the item beyond trying it on or setting it up once?\",\"reads\":[\"state.message\"],\"type\":\"noul\"}},\"result\":\"aggregations.handling\"}",
"warnings": []
}{
"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>"
}
]
}
}
}Body
application/json
A decision file to check. decision_id is optional and only checked against the id pattern.
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
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}$What the decision optimizes for, as the decision file holds it. Its outcomes must be ones structure can produce. Never part of the structure hash.
Show child attributes
Show child attributes
Response
The file is valid
Pattern:
^sha256:[0-9a-f]{64}$Each question, by name, mapped to its hash (its definition without its name). A question's hash is what feedback about it is stored against.
Show child attributes
Show child attributes
The exact text whose SHA-256 is structure_hash: the structure's canonical form in RFC 8785 (JCS) JSON.
Things that are valid but probably not meant. They never depend on an environment or a model.
Show child attributes
Show child attributes