---
title: "Messages"
method: POST
path: "/v1/messages"
tags: ["chat", "llm"]
---

# Messages

`POST /v1/messages`

## Headers

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

## Request body

- MessagesRequest
  - `model` string, required
  - `stream` boolean
  - `reasoning_effort` string, nullable
  - `reasoning_mode` string, nullable
  - `temperature` number, nullable
  - `top_p` number, nullable
  - `messages` object[], required
  - `max_tokens` integer, required
  - `thinking` object, nullable
  - `output_config` object, 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/messages/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)