---
title: "Execute Decision Model Completion (TypeSafe API)"
method: POST
path: "/v1/systemone"
tags: ["Decision Models"]
---

# Execute Decision Model Completion (TypeSafe API)

`POST /v1/systemone`

## Request

- Base URL: `https://api.swarms.world`
- URL: `https://api.swarms.world/v1/systemone`
- Auth: none declared. Required headers: `x-api-key`

Decision model completions in the TypeSafe API's exact request and response format, so the TypeSafe SDKs work with base_url set to this API. Billed like POST /v1/decision/completions; the charge is in the x-swarms-total-cost header.

## Headers

- `x-api-key` string, required

## Request body

- SystemOneRequest
  - `state` union, required: The content every question is asked about: text, a JSON object or a list.
    - string
    - object
    - unknown[]
      - unknown
  - `questions` object, required: Questions keyed by a name you choose. The answers come back under the same names.
  - `model` string, required: Decision model that answers the questions, as in the TypeSafe API. GET /v1/decision/models lists the available models and their prices.

## Response `200`

Successful Response

- SystemOneOutput
  - `model` string, required: The model version that answered, which may differ from an alias such as jev-latest.
  - `answers` object, required: Answers keyed by question name. A choice answer has choice, probabilities and confidence; a score answer has score, legend, probabilities and confidence; a noul answer has noul, the probability from 0 to 1.
  - `usage` SystemOneUsage, required
    - `input_tokens` integer, required: Input tokens reported by the provider.
    - `output_tokens` integer, required: Output tokens reported by the provider.

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-04** `ee4273b4b6ae`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/swarms/apis/swarms-api/changes/v1/systemone/post.md)

---

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