Players API

POST /api/events/[id]/players

Add a player to the event.

Field	Type	Required	Description
`name`	string	Yes	Player name (max 50 chars, trimmed)

Header	Description
`X-Client-Id`	Client identifier — used to suppress self-notifications

curl -X POST https://convocados.fly.dev/api/events/EVENT_ID/players \
  -H "Content-Type: application/json" \
  -d '{ "name": "Alice" }'

{ "ok": true }

Code	Reason
`400`	Name is empty
`404`	Event not found
`409`	Player name already exists in this event

Remove a player from the event.

Field	Type	Required	Description
`playerId`	string	Yes	The player's ID

curl -X DELETE https://convocados.fly.dev/api/events/EVENT_ID/players \
  -H "Content-Type: application/json" \
  -d '{ "playerId": "clx..." }'

If the removed player was active and there's a bench player, the first bench player is promoted
Push notifications are sent to subscribers
Webhooks are fired (player_left)

Get player name suggestions from game history. Returns names sorted by frequency, excluding current players.

{
  "players": [
    { "name": "Alice", "gamesPlayed": 5 },
    { "name": "Bob", "gamesPlayed": 3 }
  ]
}

Returns up to 30 suggestions. Only includes names from "played" (not cancelled) history entries.