Developer DocumentationAdd your app to Setapp
API Reference
  1. Decisions
  2. Decisions

Decisions

post
https://api.macpaw.com/v1/decisions

Asks a decision model typed questions about a state and returns typed answers with probabilities instead of generated text. Requests and responses follow OpenRouter's Decisions API.

Models: the entries of GET /v1/model/info with output_modality: decisions.

Required fields: model (provider/model format), state and questions (at least one).

Question types:

TypeAsksAnswer
noulyes or no; criteria has true and falsenoul: probability of yes, 0–1
choiceone of the options in criteriachoice, probabilities per option, confidence
scorea position on the ordered scale in criteriascore, probabilities per level, legend, confidence

A question the model declines comes back as an answer of type refusal; the other answers are still returned. box questions are not supported.

Output tokens are free; usage reports token counts.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

OpenRouter's Decisions API request. Fields other than model, state and questions are passed through unchanged.

string
required

Model id in provider/model format.

required
length ≥ 1

What the model reasons over: text, a JSON object, or an array of text and media parts (image_url). Must not be null or an empty string.

questions
object
required

Questions keyed by name; each answer comes back under the same name.

assets
object

Images referenced by key from state, instructions or criteria. Every asset must be referenced at least once.

string
length ≤ 256
string
length ≤ 256
Responses

Updated about 13 hours ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 13 hours ago

Did this page help you?