Artifacts

What a BinHTML artifact is, what it holds, and how it behaves from publish to expiry.

In short

An artifact is one complete HTML document plus everything BinHTML tracks about it: an owner, a share URL, a visibility setting, an expiry, a version history, and a retrievable copy of the source. The link is one view of that object, not the object itself.

What you send

A single, complete HTML document. It must contain a doctype or an <html> tag; anything shorter is rejected as an invalid document rather than published in a broken state.

There is no asset pipeline. Styles, scripts, fonts, and images should be inline or embedded as data URIs. A document that links out to a CDN will still render for viewers who can reach that CDN, but self-contained documents are the reliable choice for a link you are handing to someone else.

What you get back

Publishing returns three URLs. The share URL is the one you give to other people. The management URL opens the artifact in your dashboard. The source download URL returns the exact HTML you sent.

The response also carries the artifact id. Store it. It is what lets a later run publish a new version instead of creating a second artifact.

Share URL
binhtml.com/a/<slug>
Project share URL
binhtml.com/p/<slug>
Management URL
binhtml.com/dashboard/artifacts/<id>
Source download
binhtml.com/dashboard/artifacts/<id>/source

The lifecycle

An artifact is created, optionally updated through versions, and eventually either revoked, expired, or kept permanently on Pro. Nothing is published publicly by default: artifact pages are unlisted and noindex.

Expired artifacts are removed by a scheduled retention process. Removal covers both the metadata and the stored source, so an expired artifact is not recoverable. Keep your own copy of anything that matters.

What an artifact is not

It is not a website. There is no routing, no second page, no custom domain, and no server-side execution.

It is not a private document store. Unlisted links open for anyone holding the URL, and private visibility restricts access to your own account rather than to a group you choose.

Related