Skip to main content
POST
Evaluate decision questions
Send state and named questions to a decision model. Use GET /v1/models?category=decision for current availability and GET /v1/models/{model} for its published contract. state and each question’s instructions accept a string, JSON object, or JSON array. The endpoint returns synchronous JSON. The response preserves your question names under answers. usage.input_tokens and usage.output_tokens report observed usage when available. Pricing comes from the model’s current tariff; free output does not imply zero output tokens. Chat messages, tools, streaming, and Batch are not part of this endpoint’s contract.
The HTTP request is also usable with standard fetch or requests clients. A decision response is structured data, not a generated text explanation.

Authorizations

Authorization
string
header
required

API Key authentication. Create or manage API keys in Dashboard > API > API Keys.

Headers

X-TokenLab-Delivery-Policy
enum<string>

Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation.

Available options:
auto,
verified,
official

Body

application/json
model
string
required
Minimum string length: 1
state
required
questions
object
required

Response

Decision results

model
string
required
answers
object
required
id
string
usage
object