AI App
AI App uses type: app to create interactive pages, simulations, quizzes, demos, and small tools.
Create Example
{ "type": "app", "prompt": "Build an interactive quiz that trains employees to classify customer escalation severity", "instructions": "Give immediate feedback, show a final score, and include a restart button", "input_file_ids": ["file_xxx"], "app": { "language": "en" }}
Write an Actionable Request
Describe:
- who will use the app
- what the user should do
- what feedback should appear
- what a successful interaction looks like
- whether it needs reset, scoring, step controls, or accessibility behavior
“Build a learning app” is broad. “Build a five-question quiz with immediate explanations, a final score, and restart” is easier to turn into a usable result.
Files and URLs
AI App accepts input_file_ids for requirements, lesson notes, data, or visual references.
It does not currently advertise URL Context. A URL in prompt is not proof that the webpage was read; upload a document or screenshot when its content must be used.
Read the Result
Poll GET /creations/{id}. When it is ready, read GET /creations/{id}/outputs for the launch URL. Do not construct a URL from storage conventions.
AI App does not currently advertise the Explainer Video messages workflow. For a substantial change, create a new result with clearer prompt and instructions.
