---
title: "Create and join a puzzle race"
method: POST
path: "/api/racer"
tags: ["Puzzles"]
---

# Create and join a puzzle race

`POST /api/racer`

Create a new private [puzzle race](https://lichess.org/racer).
The Lichess user who creates the race must join the race page,
and manually start the race when enough players have joined.
- <https://lichess.org/racer>

## Response `200`

The new puzzle race.

- PuzzleRacer
  - `id` string, required
  - `url` string, uri, required

---

[API](https://skmtc.net/lichess/apis/lichess-org-api-reference.md) · [All operations](https://skmtc.net/lichess/apis/lichess-org-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lichess/lichess-org-api-reference/versions/1425db81eb3b/schema)