History API

Endpoints for listing past game results and editing scores while they are still editable.

GET /api/events/[id]/history

List all history entries for an event, ordered by date descending.

Response

[
  {
    "id": "clx9abc...",
    "eventId": "clx1abc...",
    "dateTime": "2026-03-13T19:00:00.000Z",
    "status": "played",
    "scoreOne": 3,
    "scoreTwo": 2,
    "teamsSnapshot": "{\"teamOne\":[...],\"teamTwo\":[...]}",
    "editableUntil": "2026-03-14T19:00:00.000Z",
    "createdAt": "2026-03-13T21:00:00.000Z",
    "editable": true
  }
]

Fields

Field	Type	Description
id	string	History entry ID
eventId	string	Parent event ID
dateTime	string	When the game was played (ISO 8601)
status	string	"played" or "cancelled"
scoreOne	number | null	Team one score
scoreTwo	number | null	Team two score
teamsSnapshot	string	JSON snapshot of team assignments at game time
editableUntil	string	Deadline for editing this entry (ISO 8601)
editable	boolean	Whether the entry can still be modified

PATCH /api/events/[id]/history/[historyId]

Update a history entry. Only works while editable is true (before editableUntil). Returns 403 if the edit window has closed.

Request body

Field	Type	Required	Description
status	string	No	"played" or "cancelled"
scoreOne	number | null	No	Team one score (null to clear)
scoreTwo	number | null	No	Team two score (null to clear)
teamsSnapshot	object	No	Updated team assignments

Example

curl -X PATCH https://convocados.fly.dev/api/events/EVENT_ID/history/HISTORY_ID \
  -H "Content-Type: application/json" \
  -d '{ "scoreOne": 4, "scoreTwo": 3 }'

Response

Returns the updated history entry in the same format as the GET response.

Error responses

Status	Reason
404	History entry not found
403	Edit window has expired