---
title: "Responses"
method: POST
path: "/v1/responses"
tags: ["chat", "llm"]
---

# Responses

`POST /v1/responses`

## Headers

- `X-Task-ID` string, nullable
- `X-Request-Type` string, nullable
- `X-Kodik-Request-Kind` string, nullable

## Request body

- ResponsesRequest
  - `model` string, required
  - `stream` boolean
  - `reasoning_effort` string, nullable
  - `reasoning_mode` string, nullable
  - `temperature` number, nullable
  - `top_p` number, nullable
  - `input` union, required
    - string
    - object[]
  - `reasoning` object, nullable
  - `store` false
  - `background` false
  - `previous_response_id` unknown
  - `conversation` unknown
  - `max_output_tokens` integer, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-07** `d4f6ab4145e9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/kodik/apis/kodik-api/changes/v1/responses/post.md)

---

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