Skip to content
APIs & publishing for AI agents

Ship the app.
Borrow the superpowers

Give your AI agent practical APIs for language, web research, images, voice, and documents. Then publish its static browser app to a shareable URL with one request. Promptbox does not run app backends.

Static frontends only · Standard HTTP · No SDK required · Free publishing within shared limits

01 · Enhance

Add the capabilities
your app needs.

Choose a helper, read its request and response format, and connect it to your app. The reference includes working examples, limits, and error handling.

1. Choose an APIRead the relevant endpoint and example.
2. Build & testConnect the API and check the result.
3. Publish & shareUpload your app, verify its URL, and save its token.
02 · Publish

Give your app a public URL.

Publish a static browser app to apps.promptbox.cn or a document/media file to www.promptbox.cn/publish/. Promptbox cannot run PHP, Node.js, databases, private server code, or other app backends. Both expire after 30 days; updating an app restarts its clock. For hosting beyond 30 days, contact Promptbox at admin@promptbox.cn to discuss extended hosting services.

Publish Web Apps

AI agents: start with the site guide.

Send a directory name and HTML or ZIP with assets. Apps allow 25 MiB uploaded and expanded, with index.html at the ZIP root or inside one enclosing folder.

  1. Use mode=app, directory, and file or HTML text.
  2. Save the returned URL and keep the UUID token private. Duplicate directories receive a numeric suffix.
  3. Send the token with a complete replacement build; omitted files are deleted and the 30-day lifetime refreshes.
curl https://www.promptbox.cn/api/publish.php \
  -H 'Content-Type: application/json' \
  --data '{"mode":"app","directory":"hello","text":"<!doctype html><title>Hello</title><h1>Hello world</h1>"}'

For future updates, upload the full build. An HTML-only update removes all previously uploaded assets.

For HTML or ZIP files: -F 'mode=app' -F 'directory=my-app' -F 'file=@app.zip'. Apps share browser storage on apps.promptbox.cn, isolated from other Promptbox origins. Read storage and cookie details.

Publishing guide · Capabilities · OpenClaw skill

Files and Media

Publish a document, image, audio or video

Upload one file up to 10 MiB. PDF, DOCX, XLSX, PPTX and OpenDocument formats are supported, alongside common media. UTF-8 text files allow 1 MiB.

  1. Send mode=file and one multipart file; an optional name sets its basename.
  2. Keep the URL returned by the 201 response. Duplicate filenames get a numeric suffix.
  3. Files expire after 30 days. Documents download as attachments; macros and embedded active objects are rejected.
curl https://www.promptbox.cn/api/publish.php \
  -F 'mode=file' \
  -F 'name=project-report' \
  -F 'file=@report.pdf'

Formats, limits and examples. Keep a local copy. Tokens apply to app updates only; document uploads always create a new file.

Explore what’s possible

Useful tools.
Ideas worth trying.

Adam’s collection brings together practical utilities, AI applications, and games. Use a tool today or find a starting point for your next project.

App examples

Explore assistants, image and document tools, music, and other ways to turn AI capabilities into an application.

Explore app examples

Business tools

Calculators and utilities for pricing, planning, engineering, files, and everyday work.

Find a business tool

Tools & games

Browser games, creative experiments, learning aids, converters, and media utilities.

Browse tools & games
Promptbox Consulting · Adam Chen

Put AI to work
on your own problems.

Work with Adam to explore a business workflow, develop a custom tool, or build your team’s confidence with AI through hands-on practice.

Adam Chen, founder of Promptbox Consulting

Learn from someone who builds.

Adam creates the tools and experiments you see on Promptbox. His consulting and workshops focus on applying AI to concrete tasks: working with files, connecting services, and building useful software.

Meet Adam & explore consulting
Hands-on · 3-hour workshop

Getting AI to Do Real Work

A practical workshop for people who are comfortable using a computer and want to do more with AI. Explore everyday workflows and build a useful app. No programming background is required.