Playtest Parlor

The Games API lets you create new games and retrieve a list of games you own.

List Games

Retrieve all games in your account.

Request:

GET /api/v1/games
Authorization: Bearer pp_your_token

Response:

{
  "games": [
    {
      "id": "game_1a2b3c4d",
      "name": "My Game",
      "createdAt": "2026-04-20T14:30:00Z"
    },
    {
      "id": "game_5e6f7g8h",
      "name": "Another Game",
      "createdAt": "2026-04-19T10:15:00Z"
    }
  ]
}

Response Fields:

Field	Type	Description
`games`	array	Array of game objects
`games[].id`	string	Unique game identifier
`games[].name`	string	Display name of the game
`games[].createdAt`	string	ISO 8601 timestamp when the game was created

Create Game

Create a new game ready for components and assets.

Request:

POST /api/v1/games
Authorization: Bearer pp_your_token
Content-Type: application/json

{
  "name": "My Board Game"
}

Request Body:

Field	Type	Required	Description
`name`	string	yes	Display name for the game (max 256 characters)

Response:

{
  "id": "game_1a2b3c4d",
  "name": "My Board Game",
  "createdAt": "2026-04-20T14:30:00Z"
}

Response Fields:

Field	Type	Description
`id`	string	Unique identifier for the game
`name`	string	The game name you provided
`createdAt`	string	ISO 8601 timestamp of creation

Errors:

VALIDATION_ERROR: The game name is missing or too long
UNAUTHORIZED: Your token is invalid or missing
RATE_LIMITED: You have exceeded the game creation rate limit (10 per hour)

Typical Workflow

After creating a game, you can:

Upload images as assets using the Assets API
Create game components (tiles, decks, tokens) using the Components API
Reference the game ID in all asset and component operations