---
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

---

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