API Reference/

POST/anagrama/api/hint

Requires API key

Request a hint for today's puzzle. Requires a valid CLI bearer token. Send the indices of letters already known so the server can reveal a new one.

Request Body

NameDescription
knownreq
integer[]Zero-based indices of letters the player has already uncovered.

Request

bash
curl -X POST https://api.playanagrama.com/anagrama/api/hint \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"known":[0,4]}'

Response Fields

NameDescription
index
integerZero-based position of the newly revealed letter.
letter
stringThe letter at the revealed position.
hintsUsed
integerTotal number of hints used so far.
hintsRemaining
integerNumber of hints still available.

Response 200 — Success

JSON
{
  "index": 2,
  "letter": "I",
  "hintsUsed": 1,
  "hintsRemaining": 1
}

Response 403 — No Hints Remaining

JSON
{
  "error": "no_hints_remaining",
  "message": "You have used all available hints for this puzzle."
}
The server picks an unrevealed position and returns the letter at that index. Once all hints are used, subsequent requests return a 403.
Was this page helpful?
Anagrama API Docs | Developer Reference