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

TypeSafe wire format

Use named questions and receive an answers map.

POST/v1/systemone

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
{
  "state": {
    "message": "The delivery window moved to Friday."
  },
  "questions": {
    "topic": {
      "type": "choice",
      "instructions": "Classify the message.",
      "criteria": {
        "schedule": "Timing or dates",
        "other": "Any other subject"
      }
    },
    "mentions_date": {
      "type": "noul",
      "instructions": "Does the text mention a day or date?"
    }
  },
  "model": "jev-staging-v1"
}

Response

HTTP 200 · response excerpt
{
  "model": "jev-staging-v1",
  "answers": {
    "topic": {
      "type": "choice",
      "choice": "schedule",
      "confidence": 0.84,
      "probabilities": {
        "schedule": 0.94,
        "other": 0.06
      }
    },
    "mentions_date": {
      "type": "noul",
      "noul": 0.98
    }
  },
  "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.

Discover a model

GET/v1/models

Send the same bearer token without a request body. The staging response contains a models array including jev-staging-v1.