Skip to content
gotifacts

Roll back a site (admin)

POST
/api/sites/{path}/rollback
curl --request POST \
  --url https://example.com/api/sites/example/rollback \
  --header 'Content-Type: application/json' \
  --header 'Remote-User: <Remote-User>' \
  --data '{ "revision": "example" }'

Restores a previous version (versioning must be enabled). With an empty body it restores the latest archived version; with a revision it promotes that specific revision (see GET …/revisions). Promotion copies the chosen revision to live, archiving the current content first, so the promoted revision remains in history.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters”
path
required
string

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

Request Body

Section titled “Request Body”
Media typeapplication/json

Optional rollback target. Omit revision (or send an empty body) to restore the latest archived version.

object
revision

A revision ID to promote (current is a no-op). Defaults to the latest archived version.

string
Examplegenerated
{
  "revision": "example"
}

Responses

Section titled “ Responses ”

200

Section titled “200”

The restored site.

Media typeapplication/json
object
id
required
integer format: int64
group
required

Group path (0–2 segments); empty for a flat site.

string
slug
required
string
title
required
string
description
string
date
string
tags
Array<string>
repo
string
preview

Optional preview image URL used by the portal instead of a live iframe.

string
hidden
required
boolean
size
required

Total on-disk size in bytes of the current revision’s files.

integer format: int64
has_favicon

True when the server has a cached favicon for the site, detected from the published index.html at publish time. Fetch the bytes from GET /api/sites/{path}/favicon.

boolean
created_at
required
string format: date-time
updated_at
required
string format: date-time
deleted_at

Set when the site is soft-deleted; absent for live sites.

string format: date-time
Examplegenerated
{
  "id": 1,
  "group": "example",
  "slug": "example",
  "title": "example",
  "description": "example",
  "date": "example",
  "tags": [
    "example"
  ],
  "repo": "example",
  "preview": "example",
  "hidden": true,
  "size": 1,
  "has_favicon": true,
  "created_at": "2026-04-15T12:00:00Z",
  "updated_at": "2026-04-15T12:00:00Z",
  "deleted_at": "2026-04-15T12:00:00Z"
}

400

Section titled “400”

Invalid request (bad path, malformed body, or missing content).

Media typeapplication/json
object
error
required
string
Examplegenerated
{
  "error": "example"
}

401

Section titled “401”

Missing or invalid credentials.

Media typeapplication/json
object
error
required
string
Examplegenerated
{
  "error": "example"
}

403

Section titled “403”

Authenticated, but not permitted for this target/capability.

Media typeapplication/json
object
error
required
string
Examplegenerated
{
  "error": "example"
}

404

Section titled “404”

No such site, key, or connection.

Media typeapplication/json
object
error
required
string
Examplegenerated
{
  "error": "example"
}