Set what a decision optimizes for
curl --request POST \
--url https://api.moonbounce.ai/v1/decisions/{decision_id}/objective/revisions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"objective": {
"fallback": "<string>",
"mistakes": [
{
"expected": "<string>",
"got": "<string>"
}
],
"outcome": "<string>"
}
}
'import requests
url = "https://api.moonbounce.ai/v1/decisions/{decision_id}/objective/revisions"
payload = { "objective": {
"fallback": "<string>",
"mistakes": [
{
"expected": "<string>",
"got": "<string>"
}
],
"outcome": "<string>"
} }
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({
objective: {
fallback: '<string>',
mistakes: [{expected: '<string>', got: '<string>'}],
outcome: '<string>'
}
})
};
fetch('https://api.moonbounce.ai/v1/decisions/{decision_id}/objective/revisions', 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/{decision_id}/objective/revisions",
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([
'objective' => [
'fallback' => '<string>',
'mistakes' => [
[
'expected' => '<string>',
'got' => '<string>'
]
],
'outcome' => '<string>'
]
]),
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/{decision_id}/objective/revisions"
payload := strings.NewReader("{\n \"objective\": {\n \"fallback\": \"<string>\",\n \"mistakes\": [\n {\n \"expected\": \"<string>\",\n \"got\": \"<string>\"\n }\n ],\n \"outcome\": \"<string>\"\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/{decision_id}/objective/revisions")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"objective\": {\n \"fallback\": \"<string>\",\n \"mistakes\": [\n {\n \"expected\": \"<string>\",\n \"got\": \"<string>\"\n }\n ],\n \"outcome\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.moonbounce.ai/v1/decisions/{decision_id}/objective/revisions")
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 \"objective\": {\n \"fallback\": \"<string>\",\n \"mistakes\": [\n {\n \"expected\": \"<string>\",\n \"got\": \"<string>\"\n }\n ],\n \"outcome\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"decision_id": "<string>",
"environment": "production",
"revision": 2,
"objective": {
"fallback": "<string>",
"mistakes": [
{
"expected": "<string>",
"got": "<string>",
"severity": "minor"
}
],
"target": {
"max_loss_per_case": 1
},
"outcome": "<string>",
"priority": "catch_all"
},
"objective_hash": "<string>",
"unknown_outcomes": [
"<string>"
],
"created_at": "2023-11-07T05:31:56Z",
"created": true
}{
"decision_id": "<string>",
"environment": "production",
"revision": 2,
"objective": {
"fallback": "<string>",
"mistakes": [
{
"expected": "<string>",
"got": "<string>",
"severity": "minor"
}
],
"target": {
"max_loss_per_case": 1
},
"outcome": "<string>",
"priority": "catch_all"
},
"objective_hash": "<string>",
"unknown_outcomes": [
"<string>"
],
"created_at": "2023-11-07T05:31:56Z",
"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>"
}
]
}
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"reason": "<string>",
"param": "<string>",
"details": {
"issues": [
{
"param": "<string>",
"code": "<string>",
"message": "<string>"
}
]
}
}
}objective
Set what a decision optimizes for
Stores the decision file’s objective as a new revision for the calling key’s environment, so previews and optimizers judge changes by it (a preview’s loss_report, and whether a candidate is accepted). Push it whenever the file’s objective changes; each environment keeps its own. mistakes set a loss per mistake by severity (minor 0.5, normal 1, costly 3, severe 10) or directly (loss), and an unlisted mistake is normal; fallback makes sending a case to the safe outcome minor; target is the loss per case that is good enough; outcome with priority is the two-outcome shortcut. Scores weigh each expected outcome equally however often it occurs among the scored cases, so severities say how bad a mistake is and a dataset’s mix doesn’t change the score. There are no limits on an outcome’s share, recall or precision: an objective with limits is refused. {"objective": null} clears it, back to balanced losses. The objective is not part of the structure and never changes structure_hash. 201 with the new revision; 200 and no new revision when the body matches the current one. unknown_outcomes lists outcomes the decision’s most recently registered structure (in any environment) can’t produce. 404 when the decision doesn’t exist (register a structure first). An Idempotency-Key covers the body as sent.
POST
/
v1
/
decisions
/
{decision_id}
/
objective
/
revisions
Set what a decision optimizes for
curl --request POST \
--url https://api.moonbounce.ai/v1/decisions/{decision_id}/objective/revisions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"objective": {
"fallback": "<string>",
"mistakes": [
{
"expected": "<string>",
"got": "<string>"
}
],
"outcome": "<string>"
}
}
'import requests
url = "https://api.moonbounce.ai/v1/decisions/{decision_id}/objective/revisions"
payload = { "objective": {
"fallback": "<string>",
"mistakes": [
{
"expected": "<string>",
"got": "<string>"
}
],
"outcome": "<string>"
} }
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({
objective: {
fallback: '<string>',
mistakes: [{expected: '<string>', got: '<string>'}],
outcome: '<string>'
}
})
};
fetch('https://api.moonbounce.ai/v1/decisions/{decision_id}/objective/revisions', 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/{decision_id}/objective/revisions",
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([
'objective' => [
'fallback' => '<string>',
'mistakes' => [
[
'expected' => '<string>',
'got' => '<string>'
]
],
'outcome' => '<string>'
]
]),
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/{decision_id}/objective/revisions"
payload := strings.NewReader("{\n \"objective\": {\n \"fallback\": \"<string>\",\n \"mistakes\": [\n {\n \"expected\": \"<string>\",\n \"got\": \"<string>\"\n }\n ],\n \"outcome\": \"<string>\"\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/{decision_id}/objective/revisions")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"objective\": {\n \"fallback\": \"<string>\",\n \"mistakes\": [\n {\n \"expected\": \"<string>\",\n \"got\": \"<string>\"\n }\n ],\n \"outcome\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.moonbounce.ai/v1/decisions/{decision_id}/objective/revisions")
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 \"objective\": {\n \"fallback\": \"<string>\",\n \"mistakes\": [\n {\n \"expected\": \"<string>\",\n \"got\": \"<string>\"\n }\n ],\n \"outcome\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"decision_id": "<string>",
"environment": "production",
"revision": 2,
"objective": {
"fallback": "<string>",
"mistakes": [
{
"expected": "<string>",
"got": "<string>",
"severity": "minor"
}
],
"target": {
"max_loss_per_case": 1
},
"outcome": "<string>",
"priority": "catch_all"
},
"objective_hash": "<string>",
"unknown_outcomes": [
"<string>"
],
"created_at": "2023-11-07T05:31:56Z",
"created": true
}{
"decision_id": "<string>",
"environment": "production",
"revision": 2,
"objective": {
"fallback": "<string>",
"mistakes": [
{
"expected": "<string>",
"got": "<string>",
"severity": "minor"
}
],
"target": {
"max_loss_per_case": 1
},
"outcome": "<string>",
"priority": "catch_all"
},
"objective_hash": "<string>",
"unknown_outcomes": [
"<string>"
],
"created_at": "2023-11-07T05:31:56Z",
"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>"
}
]
}
}
}{
"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]+$Path Parameters
Pattern:
^[a-z][a-z0-9_.-]{0,127}$Body
application/json
The decision file's objective, as written there. Null clears it, back to balanced losses.
Show child attributes
Show child attributes
Response
Unchanged: the body matches the current revision
Pattern:
^[a-z][a-z0-9_.-]{0,127}$The environment of the key that made the call: production or test. Evaluations, feedback, reviews and suggestions are separate per environment; registered structures are shared.
Available options:
production, test The objective revision. Null when none was ever set here, which means balanced losses.
Required range:
x >= 1The stored objective. Null means balanced losses: each outcome's mistakes weigh the same in total.
Show child attributes
Show child attributes
The objective's hash, as loop status and previews report it. Null with objective. Compare it with the decision file's to see drift.
Outcomes the objective names that the decision's most recently registered structure can't produce. Their entries will be left out of scoring; check for a typo or a renamed outcome. Empty when that structure's result is a value, with no outcomes to check against.
False when the body matched the current revision, so nothing was written.