Skip to content
gotifacts
Search
Ctrl
K
Cancel
GitHub
Select theme
Dark
Light
Auto
Menu
Tutorials
Run gotifacts locally
Publish your first site
How-to guides
Deploy with Docker
Configure nginx
Configure Caddy
Create & scope API keys
Publish from CI
Publish with the Claude skill
Connect Claude via MCP
Enable versioning & roll back
Frame sites in the portal
Deploy a site from the portal
Reference
Configuration
CLI
URL ⇄ path convention
Permissions
HTTP API
Overview
Management
Overview
Current user
List sites
Upload a site (admin)
Get a site's metadata
Unpublish a site (admin)
Update site metadata (admin)
List quarantined (soft-deleted) sites (admin)
Restore a quarantined site (admin)
Permanently delete a quarantined site (admin)
Roll back a site (admin)
Fetch a site's favicon
List a site's revisions
Browse a revision's file tree
Download a single file from a revision
Download a whole revision as a zip
List API keys (admin)
Create an API key (admin)
Revoke an API key (admin)
Load the MCP consent screen
Approve or deny an MCP connector
List MCP connections (admin)
Revoke an MCP connection (admin)
Ingest
Overview
Publish (create or replace) a site
Unpublish a site
Update site metadata
List a site's revisions (ingest plane)
Roll back a site
Permanently delete a quarantined site
Explanation
Architecture
The two-plane auth model
Security & threat model
GitHub
Select theme
Dark
Light
Auto
Overview
Ingest
Section titled “Ingest”
Machine publish plane (
/ingest/*
), API-key authenticated.
Operations
Section titled “ Operations ”
POST
/ingest/sites
DELETE
/ingest/sites/{path}
PATCH
/ingest/sites/{path}
GET
/ingest/sites/{path}/revisions
POST
/ingest/sites/{path}/rollback
POST
/ingest/sites/{path}/purge
