Skip to main content
POST
Decisions API
See the classification and scoring 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

Function name for tracing and project-level guardrail function-scope filtering.

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"

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 October 7, 2026