REST API

Games

The catalog of games available for AI-generated content. Use this to populate game pickers and validate input on your side.

List games

http

GET /api/v2/games

GET/api/v2/gamesscope · games:read

API baseAPI key

curl -X GET 'https://hub.playgent.com/api/v2/games'

Response

Send the request to see the response. Your key is stored in this browser only.

Response:

json

{
  "object": "list",
  "data": [
    {
      "id": "trivia",
      "name": "Trivia",
      "description": "Answer trivia questions on any topic.",
      "category": "knowledge",
      "modes": ["pinned", "daily", "random"],
      "default_mode": "pinned",
      "difficulties": ["easy", "medium", "hard"],
      "supports_generation": true,
      "supports_sources": ["topic", "url", "text"],
      "cover": "https://static.playgent.com/trivia/logo.png"
    }
  ]
}

Field reference

Field	Type	Notes
`id`	string	Use as `game` in calls to `Playgent.init` and content creates.
`name`	string	Customer-facing display name.
`description`	string	One-sentence summary suitable for UI.
`category`	string	High-level grouping: words / knowledge / images / casual / numbers / logic / geography / cards.
`modes`	string[]	Which modes the game supports.
`default_mode`	string	The mode the Hub Playground opens with.
`difficulties`	string[]	Game-specific labels — `easy`/`medium`/`hard` is most common.
`supports_generation`	boolean	If `false`, generate-from-input isn't supported (mostly seeded games).
`supports_sources`	string[]	Which `input_type`s `POST /api/v2/content` accepts for this game.
`cover`	string	Public cover image URL.

Players

Overview