Skip to main content
POST
Decisions API
See the decision models guide for working examples, model discovery, and usage and billing behavior.

Authorizations

Authorization
string
header
required

API key authentication. Pass your API key as a Bearer token.

Headers

X-Opper-Name
string

Names the call. The model span takes this name, and so does the trace when that span is its root. Up to 256 bytes.

X-Opper-Parent-Span-Id
string<uuid>

Parent span ID for distributed tracing context.

X-Opper-Tags
string

Comma-separated key:value usage-attribution tags (e.g. tenant:acme,project:demo, max 8). Recorded on the generation's billing/metrics rows; group spend by any key via GET /v2/analytics/usage?group_by=. Header-borne twin of the /v3/session URL prefix tags (which win per key when both are present); opper.-prefixed keys and session_id are reserved. Malformed values return 400.

Body

application/json
input
required
model
string
required
Minimum string length: 1
Example:

"gpt-6-luna-decisions"

questions
object[]
required
Minimum array length: 1
safety_identifier
string

Accepted for compatibility with OpenAI's API, then dropped: Opper neither forwards nor stores it. Requests to OpenAI carry Opper's own identifier for your project.

Response

Successful response

answers
object[]
required

One answer per question, in question order.

model
string
required
usage
object
required
Last modified on November 10, 2026