---
title: "POST /v0/responses"
method: POST
path: "/v0/responses"
---

# POST /v0/responses

`POST /v0/responses`

Create a model response

## Request body

- object
  - `include` string[]
  - `input` union[], required
    - union
      - object
        - `type` 'message'
        - `role` 'user' | 'system' | 'developer', required
        - `content` union[], required
          - union
            - object
              - …
            - object
              - …
      - object
        - `id` string, required
        - `type` 'message', required
        - `role` 'assistant', required
        - `status` 'in_progress' | 'completed' | 'incomplete', required
        - `content` union[], required
          - union
            - object
              - …
            - object
              - …
      - object
        - `id` string, required
        - `summary` object[], required
          - `type` 'summary_text', required
          - `text` string, required
        - `type` 'reasoning', required
        - `encrypted_content` string
        - `status` 'in_progress' | 'completed' | 'incomplete'
  - `model` 'witan-alfred' | 'witan-alfred-mini' | 'witan-edward' | 'witan-edward-mini'
  - `stream` boolean

## Response `200`

OK

- object
  - `id` string, required
  - `object` 'response', required
  - `created_at` integer, required
  - `status` 'completed' | 'in_progress' | 'failed', required
  - `output_text` string, required
  - `error` object, nullable, required
    - `code` 'server_error', required
    - `message` string, required
  - `incomplete_details` unknown, required
  - `instructions` unknown, required
  - `metadata` unknown, required
  - `model` 'witan-alfred' | 'witan-alfred-mini' | 'witan-edward' | 'witan-edward-mini', required
  - `output` union[], required
    - union
      - object
        - `id` string, required
        - `type` 'message', required
        - `role` 'assistant', required
        - `status` 'in_progress' | 'completed' | 'incomplete', required
        - `content` union[], required
          - union
            - object
              - …
            - object
              - …
      - object
        - `id` string, required
        - `summary` object[], required
          - `type` 'summary_text', required
          - `text` string, required
        - `type` 'reasoning', required
        - `encrypted_content` string
        - `status` 'in_progress' | 'completed' | 'incomplete'
  - `parallel_tool_calls` false, required
  - `temperature` unknown, required
  - `tool_choice` 'none', required
  - `tools` object[], required
    - `type` string, required
  - `top_p` unknown, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/witanlabs/apis/witan-labs-api.md) · [All operations](https://skmtc.net/witanlabs/apis/witan-labs-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/witanlabs/witan-labs-api/revisions/69e42ddaf375/schema)