Playable Gift

This is the advanced path, so use make_game unless the sender asks you to write the game yourself. It saves a complete self-contained HTML game you wrote as a free private draft, and returns a preview link (previewUrl) and a private managementToken. Build the gameplay around the sender's details, with inline CSS and JavaScript, embedded assets, keyboard and touch controls, a goal and a restart. The game can't make network requests or take payments. Generate a random 32-byte hex idempotencyKey and reuse it only to retry the same request. Keep the managementToken private.

Export a draft as portable JSON with its complete self-contained game HTML, without the recipient's email address or private tokens. Pass revision to export one of the five kept revisions instead of the current one.

Read a draft saved with create_custom_game, with its current revision, preview link and status, using its private managementToken. The game's HTML is not included; use export_gift for it.

Read the requirements and limits for saving a game you wrote yourself with create_custom_game. You don't need this for make_game.

Read the last five revisions of a draft, without game HTML. They include personal content, so keep them private. Use export_gift with a revision number to read one revision's game.

Check a game started with make_game. While it builds, this returns the stage and, once known, the title and cast. When state is complete, it returns shareUrl, the play link to give the sender so they can send it to the recipient, and manageUrl, a private link for the sender only. Never share manageUrl with anyone else.

Make a small video game about one person with Playable Gift's game maker, from two or three specific things the sender told you about them, like habits or inside jokes. Ask the sender for the recipient's name and those details first if you don't have them. This returns at once while the game builds. Then call get_made_game with the same idempotencyKey every 10 seconds until state is complete, which takes about a minute. It's free within a small daily allowance, and it never charges anyone or sends a message.

Replace a draft saved with create_custom_game with a revised self-contained HTML game and details. Read the current HTML with export_gift, make the change in it, and pass expectedRevision so you don't overwrite another edit.