Objects
| Object | Meaning |
|---|---|
| Workspace | The tenant that owns Artifacts, members, API Keys, Plan, and Audit Events. |
| Artifact | A durable, addressable folder-like package containing one or more files. |
| Revision | An immutable saved state of an Artifact after publish. New publishes append Revisions. |
| Published Revision | The Revision currently visible through stable Artifact links. |
| Artifact URL | The app-origin live viewer for an Artifact. It resolves to the latest Published Revision. |
| Revision Content URL | A signed Content Origin URL for one exact Revision. It expires and does not Live Update. |
| Access Link | A revocable signed URL for a Share Link or a Revision Link. |
| Share Link | An Access Link that resolves to the latest Published Revision of an Artifact. |
| Bundle | A downloadable archive generated from a complete Revision file tree. |
IDs and handoff URLs
Publish returns stable Artifact and Revision IDs plus an Artifact URL for the live viewer. The direct usercontent.agent-paste.sh/v/... URL is the Revision Content URL for one exact Revision.
art_01HZ8K2X9NPQR3VW7TYBE5MCDF
rev_01HZ8K2X9NPQR3VW7TYBE5MCDFRevisions and Live Updates
Publishing to an existing Artifact creates a new Published Revision. Old Revisions remain addressable through Revision Links while retained by the Workspace policy.
On Pro, Live Updates let already-open Artifact URL, Private Link, or Share Link viewers advance to the latest Published Revision without a manual reload. Revision Links and Revision Content URLs are pinned to one Revision and do not Live Update. Draft Revisions are never revealed.
Agent View
Agent View is JSON for machines. It includes Artifact and Revision IDs, title, entrypoint, file metadata, signed per-file URLs, and Bundle Availability. It does not inline file bytes.