---
title: "Make a chess move use SAN format. Convert from UCI if necessary. Display the results to the user."
method: POST
path: "/api/move"
---

# Make a chess move use SAN format. Convert from UCI if necessary. Display the results to the user.

`POST /api/move`

## Request body

- object
  - `move` string — The move to make in Standard Algebraic Notation (SAN), e.g., "e4", "Nf3".

## Response `200`

Updated game state and board information

- BoardState
  - `game_over` boolean — Indicates if the game is over
  - `display` string — Markdown string to display the board
  - `best_moves` string — A comma-separated list of the assistant's best moves in SAN format
  - `EXTRA_INFORMATION_TO_ASSISTANT` string — Instructions for the assistant on how to proceed

## Other responses

- `400` — Bad request, illegal or invalid move
- `404` — Game not found

## Changes

> 9 revisions in range; 1 could not be searched.

- **2023-05-05** `7ecbc70f0627` — 8 breaking, 8 info
  - the response property `EXTRA_INFORMATION_TO_ASSISTANT` became optional for the status `200`
  - the response property `display` became optional for the status `200`
  - the response property `game_over` became optional for the status `200`
  - removed the required property `EXTRA_INFORMATION_TO_ASSISTANT` from the response with the `400` status
  - …12 more
- **2023-04-17** `001634e13582` — 4 breaking
  - removed the required property `FEN` from the response with the `200` status
  - removed the required property `FEN` from the response with the `400` status
  - removed the required property `move_history` from the response with the `200` status
  - removed the required property `move_history` from the response with the `400` status
- **2023-04-17** `0e0b8108479b` — 1 breaking, 1 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `404`
  - added the required property `error` to the response with the `404` status
- **2023-04-17** `374395125ddd` — 3 breaking, 6 info
  - the response's body type/format changed from `object`/`` to ``/`` for status `404`
  - removed the required property `error` from the response with the `400` status
  - removed the required property `error` from the response with the `404` status
  - added the required property `EXTRA_INFORMATION_TO_ASSISTANT` to the response with the `400` status
  - …5 more
- …earlier changes not shown

[Full history](https://skmtc.dev/atomic14/apis/chess-assistant-api/changes/api/move/post.md)

---

[API](https://skmtc.dev/atomic14/apis/chess-assistant-api.md) · [All operations](https://skmtc.dev/atomic14/apis/chess-assistant-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/atomic14/chess-assistant-api/revisions/8ab254be01c9/schema)