Unpublish a site (admin)

DELETE

/api/sites/{path}

• Your gotifacts apex (canonical base domain), fronted by your reverse proxy. Any configured alias domains serve the same API and sites, but responses (e.g. base_domain) always report the canonical domain.

Soft-deletes the site: takes it offline immediately by moving its files to a quarantine directory, and sets deleted_at on the registry row. Files and the row are permanently removed by the background purge after the GOTIFACTS_DELETED_SITE_TTL (default 30 days). Re-publishing the same slug before that deadline restores the site.

Authorizations

• forwardAuth

Parameters

Path Parameters

path

required

string

Full site path — group segments (0–2) plus the slug, e.g. claude/app or demo.

Responses

204

Unpublished (soft-deleted).

401

Missing or invalid credentials.

object

error

required

string

403

Authenticated, but not permitted for this target/capability.

object

error

required

string

404

No such site, key, or connection.

object

error

required

string