Draft & publish

List what changed in the draft since the last publish

Everything staged and not yet live: content files, routes and menu items, each new, modified or deleted. Review it before publishSite: send the {key, hash} pairs you reviewed (a route's path goes in key) and this fingerprint as reviewedSet, so the publish answers 409 drafts_changed instead of shipping something that moved after you looked. Add verify=1 to also get the last verifySite run and whether the draft changed since. Safe to call repeatedly.

get/api/v1/sites/{slug}/draft-status

Request

  • Base URL: https://api.dotsy.ai
  • URL: https://api.dotsy.ai/api/v1/sites/{slug}/draft-status
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

slugstring required
Example:acme-studio

Site slug or site id (UUID). An old slug answers 301/308 and a site id 307 to the canonical slug path.

Query parameters

verify'1'

1: add verify, the last verifySite run and whether it is stale.

Response

The staged changes.

totalinteger required

Staged changes in all three lists.

fingerprintstring required

One opaque token for the whole staged state. If it is unchanged when you publish, nothing moved since you looked.

indexState'building'

The staged-set index is being rebuilt, so the lists above may be a subset of what is staged.

Example response

{
  "content": [
    {
      "key": "blog/launch.html"
    }
  ],
  "routes": [
    {
      "path": "/blog/launch"
    }
  ],
  "menus": [
    {
      "menu": "primary"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.