Sharing Artifacts

Artifacts start private. Sharing is a deliberate step, viewers see one live version, and you choose which one that is.

1belt artifact share acme/q3-funnel

Visibility

An artifact is a capture of one person's work until it is explicitly shared, so it is created private. From there it can be shared with named people or workspaces, or made public. A public artifact is readable by anyone with the link, signed in or not.

Visibility controls who may call the artifact API. It does not put page source or uploaded assets on the public file CDN used for task uploads. Those bytes live in a separate private object store and are served only through artifact routes (content, render, frame, asset download) after the same read check as GET /artifacts/{id}. Guessing an object key does not bypass that. The read check admits a viewer to the live version only; see Versions.

Versions

Every publish appends a version, but an artifact has one live version and that is all a viewer is served. By default it is the latest one, so updating the page updates it for everyone who has it open.

The history is private to the owner and editors (people shared with write permission, and workspace members). Viewers cannot list versions, and a link carrying another version id resolves to the live version in the browser; against the API it is not found.

1belt artifact versions acme/q3-funnel

You can pin instead. Pinning a version makes it the live one: viewers keep seeing that version while you keep publishing — useful when a link has gone out and you want to keep working without changing what people already opened. Pinning changes which version is live; it hides nothing from editors, who still see and can open every version.

Comments

People can leave comment threads on a published artifact.

1belt artifact comments acme/q3-funnel2belt artifact comments resolve acme/q3-funnel <thread-id>

A thread can be sent to an agent, which can then reply into it and resolve it once it has acted.

Reading one back

1belt artifact get acme/q3-funnel            # the source you published2belt artifact get acme/q3-funnel --render   # the wrapped document3belt artifact open acme/q3-funnel           # in a browser

Each reads the live version. Other versions are reachable to editors only.

Indexing

Published pages carry noindex, nofollow. Anyone can publish a page here; none of them should turn up in a search index on our behalf.