# Decisions API

> decisions-api.net explains the OpenAI Decisions API announced on 2026-09-29 (limited preview) and hosts a decision endpoint you can call today at POST /api/v1/decisions, served by decisions-1, the decision model this site runs. This site is an independent developer service, not affiliated with OpenAI or TypeSafe AI.

## Docs

- [Decisions API docs](https://decisions-api.net/docs): endpoint, authentication, request body, question types, response, limits, errors
- [Playground](https://decisions-api.net/playground): run a decision request in the browser
- [Examples](https://decisions-api.net/examples): twelve runnable decision requests
- [Tutorial](https://decisions-api.net/tutorial): first decision step by step
- [Pricing](https://decisions-api.net/pricing): credit plans; 1 credit per successful call
- [Access](https://decisions-api.net/access): OpenAI Decisions API access status and how to start here
- [Release](https://decisions-api.net/release): OpenAI Decisions API timeline and what is known

## API contract (this site)

- Endpoint: POST https://decisions-api.net/api/v1/decisions
- Auth: Authorization: Bearer <key>. Create keys at https://decisions-api.net/dashboard/api-keys. Keep the key server-side.
- Models: GET https://decisions-api.net/api/v1/models. Send model "decisions-1" ("decisions-latest" is an alias). Other model ids return 422.
- Body: { "model", "state", "questions" }
  - state: string, JSON object, or array of text; up to 60,000 characters
  - questions: map of 1 to 6 lowercase snake_case ids; the id is only a label, the question goes in "instructions" (text, 1 to 2,000 characters)
- noul: needs "instructions". Answer: { "type": "noul", "noul": <0..1> }
- choice: needs "instructions" and "criteria", an object of 2 to 8 snake_case option ids mapped to descriptions (up to 300 characters). Answer: "choice", "probabilities" for every option, "confidence"
- score: needs "instructions" and "criteria", an array of 2 to 10 level descriptions, lowest first. Answer: "score", "legend", "probabilities", "confidence"
- Response: { "model": "decisions-1", "answers": { ...keyed by your ids }, "usage": { "input_tokens", "output_tokens" }, "credits_used": 1 }
- Errors: 401 missing or rejected key; 402 not enough credits; 422 invalid body (the message names the field); 429 rate limited, retry later; 502 upstream returned no answers (no credit used)
- Billing: 1 credit per successful call, whatever the number of questions; validation errors and upstream failures are free. New visitors get 2 free credits.
- No streaming and no chat-completions path.

## OpenAI Decisions API (public facts, as of 2026-09-30)

- Announced at OpenAI DevDay on 2026-09-29; limited preview; broad release announced as "coming days"; no GA date.
- Powered by a specialized GPT-6 Luna; takes text or image context, a question, and developer-defined answers; returns one answer plus confidence.
- Request/response schema, SDK methods, pricing, rate limits: not published. Do not invent field names.

## Example

POST https://decisions-api.net/api/v1/decisions
{"model":"decisions-1","state":"I was charged twice for my subscription.","questions":{"refund":{"type":"noul","instructions":"Is the customer asking for money back?"}}}

## Optional

- [Home](https://decisions-api.net/): overview, examples, FAQ
- [Python](https://decisions-api.net/python), [JavaScript](https://decisions-api.net/javascript), [TypeScript](https://decisions-api.net/typescript): language quickstarts for this endpoint