---
title: "Start a new chess game. Creates a board in the default state for a new game."
method: POST
path: "/api/new_game"
---

# Start a new chess game. Creates a board in the default state for a new game.

`POST /api/new_game`

## Request body

- object
  - `assistant_color` 'white' | 'black' — The color the chess assistant will play as. Must be "white" or "black".
  - `elo` integer — The Elo rating at which the assistant will play, must be between 1000 and 3000.

## Response `200`

New 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, invalid assistant color or Elo rating

## Changes

- **2026-07-17** `8ab254be01c9` — 2 warning
  - removed the optional property `FEN` from the response with the `200` status
  - removed the optional property `move_history` from the response with the `200` status
- **2023-05-05** `7ecbc70f0627` — 4 breaking, 9 info
  - request property `assistant_color` was restricted to a list of enum values
  - 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`
  - …9 more
- **2023-04-17** `001634e13582` — 2 breaking
  - removed the required property `FEN` from the response with the `200` status
  - removed the required property `move_history` from the response with the `200` 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` — 2 breaking
  - the response's body type/format changed from `object`/`` to ``/`` for status `404`
  - removed the required property `error` from the response with the `404` status

[Full history](https://skmtc.dev/atomic14/apis/chess-assistant-api/changes/api/new_game/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)