Documentation / API reference
OpenAI Decisions wire format
Use ordered questions and receive an ordered array of answers.
POST
/v1/decisionsThis is a staging-compatible subset, not a general vendor proxy. The base URL for the TypeSafe SDK is the origin; the OpenAI SDK base URL ends in /v1. Do not append /v1 twice.
Direct request
JSON
{
"input": "The delivery window moved to Friday.",
"model": "decisions-staging-v1",
"questions": [
{
"name": "mentions_date",
"type": "predicate",
"instructions": "Does the text mention a day or date?"
}
]
}Response
HTTP 200 · response excerpt
{
"model": "decisions-staging-v1",
"answers": [
{
"name": "mentions_date",
"type": "predicate",
"probability": 0.96
}
],
"usage": {
"input_tokens": 74,
"output_tokens": 12
}
}Select a policy instead
Set arbiro.policy or the X-Arbiro-Policy header. Use arbiro.external_id for correlation and Idempotency-Key for retries. Body extensions take precedence over the corresponding headers.
Supported mappings
| predicate | Maps to noul; returns probability. |
|---|---|
| choice | Pass choices containing value and description. |
| score | Pass ordered levels with label and description; staging accepts 2–10 levels. |