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

---

[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/versions/8ab254be01c9/schema)