Draft & publish

Compose draft pages and report broken markup, assets and SEO

Renders each page of the draft the way a visitor would see it after publishing and reports what is wrong: unresolved <dotsy-*> tags, missing layouts, content or assets, broken menu wiring, redirect problems and SEO errors. It checks the draft, not the live site. It composes every page, so pass paths to check just a few. It records an SEO snapshot, which the dashboard shows.

post/api/v1/sites/{slug}/verify

Request

  • Base URL: https://api.dotsy.ai
  • URL: https://api.dotsy.ai/api/v1/sites/{slug}/verify
  • 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.

Request body

pathsstring[]

Route paths to check. Omit it to check every route on the site; a :param route such as /blog/:slug is checked through one real page of the draft (checked), and skipped when it has none.

Example request

{
  "paths": [
    "/",
    "/about"
  ]
}

Response

The findings.

okboolean required

True when there are no site issues and every checked path is ok.

redirectScanPartialtrue

The redirect scan hit its cap, so some redirect targets may have been misjudged.

Example response

{
  "warnings": [
    {
      "code": "missing_asset"
    }
  ],
  "siteIssues": [
    {
      "code": "missing_asset"
    }
  ],
  "paths": [
    {
      "checked": "/blog/hello",
      "issues": [
        {
          "code": "missing_asset"
        }
      ],
      "seoIssues": [
        {
          "code": "missing_asset"
        }
      ]
    }
  ]
}

Changes

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