Publish a web page or site
publish_sitePut a web page or small static site you created online instantly. Pass {"files": {"index.html": "…", "style.css": "…", "app.js": "…"}} (paths relative to the site root; index.html required). Images can go in base64_files. Returns the public URL. Pages are served sandboxed on their own link.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | No | Custom link name (3-40 letters, digits, dashes); available on plans with custom names. | |
| files | Yes | Map of path -> text content, e.g. {"index.html": "<!doctype html>…", "style.css": "body{…}"}. Must include index.html. | |
| title | No | Name for the site (shown in the dashboard). | |
| password | No | Visitors must enter this password to open the link; available on plans with password protection. | |
| base64_files | No | Optional map of path -> base64 content for binary assets such as images. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The public link to share. | |
| kind | Yes | html | site | file | bundle | pending | |
| slug | Yes | ||
| title | Yes | ||
| views | Yes | View count; null when the link's account plan has no view counts, or the link has no account. | |
| status | Yes | checking = not live yet (poll get_link); live = shareable; unpublished = not published; publishing = will be live soon (poll get_link); in_review = not available right now; removed = removed by moderation (see removed_reason, appeal_url). | |
| permanent | Yes | ||
| appeal_url | No | Only with status removed: mailto link to appeal to abuse@putit.online. | |
| created_at | Yes | ||
| expires_at | Yes | ISO time the link stops working; null for permanent links. | |
| file_count | Yes | ||
| manage_url | No | Private page to manage/delete the link. Only returned on creation; keep it secret. | |
| size_bytes | Yes | ||
| checkout_url | No | Only with status unpublished: the page where the uploader can publish this link. | |
| manage_token | No | Secret token for get_link/delete_link without an account. Only returned on creation. | |
| removed_reason | No | Only with status removed: why, in plain words. | |
| status_message | Yes | ||
| removed_category | No | Only with status removed: the moderation category (malware, phishing, explicit, …); null when not disclosed. | |
| password_protected | Yes |