arbiro/DocsBack to site ↗
Browse documentation
Documentation  /  API reference

OpenAI Decisions wire format

Use ordered questions and receive an ordered array of answers.

POST/v1/decisions

This 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

predicateMaps to noul; returns probability.
choicePass choices containing value and description.
scorePass ordered levels with label and description; staging accepts 2–10 levels.