Home
Logospell · Docs

Recent generations tool

Nothing is lost to a dropped connection: list_recent_generations returns your recent generations with fresh download links. Free to call.

scroll ↓
01 / 01 · How it works
The recovery tool

list_recent_generations

If the connection drops before a result message arrives, the generation may still have completed, and generations are billed when they finish, not when the message lands. Have your client call this tool and it returns your recent generations, newest first, each with its download URL, so the work is recovered rather than repeated.

list_recent_generations
# Your AI calls the tool
list_recent_generations(limit: 5)

# It responds with your recent generations, newest first,
# each with its tool, subjects, and a download URL for its zip
limitintegeroptional

Maximum number of recent generations to return. Up to 20.

Default: 5

Download URLs are short-lived, and re-listing does not extend an existing download's expiry, so have your client fetch the zip promptly once recovered.