---
title: "Create a decision (OpenAI format)"
method: POST
path: "/decisions"
tags: ["Decisions"]
---

# Create a decision (OpenAI format)

`POST /decisions`

## Request

- Base URL: `https://api.munito.ai/inference/v1`
- URL: `https://api.munito.ai/inference/v1/decisions`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

OpenAI's Decisions contract: ordered Predicate, Choice, and Score questions about one input, answered in the same order with probabilities. Use an OpenAI base URL of https://api.munito.ai/inference/v1 and call this path over HTTP. The models, rate limits, billing, and errors are those of Evaluate decisions, with OpenAI error envelopes. perplexity-ai/pplx-decider-v1.2 accepts up to 8 input_image parts whose image_url is a base64 data URL; an image link gets 400. blockbrain/cygnet is text only, and a request with an image gets 400.

## Headers

- `munito-service-tier` 'priority' | 'standard' | 'flex'

## Request body

- object
  - `model` string, required: A decision model available to your account.
  - `input` union, required: A string, or user messages whose content is a string or input_text and input_image parts. Images go to perplexity-ai/pplx-decider-v1.2 only.
    - string
    - object[]
  - `questions` object[], required: 1 to 64 questions, in answer order.
    - `type` 'predicate' | 'choice' | 'score', required
    - `instructions` string, required: The question or rubric.
    - `name` string: An optional name, returned with the answer.
    - `choices` object[]: Choice only: 2 to 255 distinct values (string or boolean), each with an optional description.
    - `levels` object[]: Score only: 2 to 10 ordered levels, lowest first, each with a label and an optional description.
  - `safety_identifier` string: Up to 128 characters. Accepted and not used.

## Response `200`

Answers in question order. A predicate returns its probability. A choice returns the chosen value, its confidence, and the probability of each value. A score returns the expected level, its confidence, and the probability of each level.

## Other responses

- `400`: Invalid request or unavailable decision model, in an OpenAI error envelope.
- `401`: Authentication failed, in an OpenAI error envelope.
- `429`: Rate limit exceeded. Retry according to the Retry-After header.

---

[API](https://skmtc.dev/munito/apis/munito-ai-api.md) - [All operations](https://skmtc.dev/munito/apis/munito-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/munito/apis/munito-ai-api/revisions/d4ccbe8844df?raw)