Awards
Custom editions with categories, nominees and winners.
An edition can use the catalogue, an author's list or games logged during its year. Source lists are followed live: removed games stop appearing as nominees or winners. Drafts are private. The version field prevents a tab from overwriting newer changes.
/api/ v1/ awards24 visible editions per page. view=mine or community; username filters the author; page=1..1000. Drafts are owner-only.
/api/ v1/ awardsCreates an edition. name (1..100), year (1970..9999), mode (PERSONAL/PREDICTIONS), rules (up to 5000), source (CATALOG/LIST/PLAYED_YEAR), source_list_id (owned list UUID for LIST), visibility, status (DRAFT/PUBLISHED), categories (1..30). Each category: UUID id, name, description, max_nominees (1..20), nominees (unique IDs), winner (nominated ID or null). Publishing requires a nominee per category.
/api/ v1/ awards/ {id}Visible edition with games and categories filtered by current eligibility. invalid_ids is owner-only. Accepts UUID or public_id.
/api/ v1/ awards/ {id}Replaces the complete document using POST fields and version from the last read. Version conflicts return 409; games outside the eligible pool are refused.
/api/ v1/ awards/ {id}Deletes an edition owned by the caller.
/api/ v1/ awards/ {id}/ eligibleOwner-only: 48 eligible games per page, q searches by slug, page=1..1000. CATALOG suggests library games; general search uses the catalogue API.
/api/ v1/ awards/ sourcesThe caller's lists for choosing a source. 48 per page; q searches names and page=1..1000.