Artifacts
Publish static sites and agent outputs to a shareable URL
Artifacts host static sites (HTML, CSS, JS, images) on a public URL. Use them for AI agent outputs like feature previews, reports, or summaries, or any small static site you want to share without deploying a service.
Each organization gets one shared artifacts bucket. Every artifact is a folder in that bucket with its own URL:
https://<your-org>.artifacts.rock8.cloud/<slug>/The root index.html is served at that URL.
Publishing
Artifacts are published by an AI coding agent through the MCP integration. Ask your agent to publish and it calls the publish_artifact tool:
- First publish provisions your org's bucket. This takes about a minute and the agent waits automatically.
- Slug is the URL path segment (lowercase letters, digits, dashes). Omit it to auto-generate, or reuse one to update an existing artifact.
- Republishing the same slug replaces the whole site. Files not in the new upload are deleted.
The API token needs the write:artifacts scope.
Limits
| Limit | Value |
|---|---|
| Total per publish | 5 MB |
| Per file | 1 MB |
| Files per publish | 200 |
Access control
Artifacts are protected by default with HTTP basic auth. The agent sets a username and password on first publish, or you set public: true to serve without a credential.
Manage access in the dashboard under Artifacts on any project:
- Public access toggle switches between open and basic-auth protected. Making an artifact public prompts for confirmation - anyone with the URL can then view it.
- Rotate password issues a new password. It is shown once, so store it immediately. Passwords are stored hashed and can't be shown again.
- Title is an optional human-readable label shown in listings. The slug is used if you leave it blank.
Managing artifacts
The Artifacts section lists every artifact in the org with its URL, size, file count, and last update. From there you can:
- Open files to browse the published files in the bucket.
- Copy or open the public URL.
- Edit access per artifact - toggle public/protected, rotate the basic-auth password, or rename it (see Access control above).
- Delete an artifact. This removes all its files from storage and cannot be undone.
Bucket storage
The shared bucket is drawn from your plan's S3 storage quota (100 MB minimum). Expand it under Bucket settings → Resize. Increasing the cap draws from your unallocated storage quota.
Agents and the dashboard can also delete or list artifacts via the delete_artifact and list_artifacts MCP tools.