Artifacts

Verify — what viewers see and what broke

Changed on

Opens the page the way its viewers get it — on its content origin, in a fresh browser with no ShareOut session, with the viewer sandbox emulated (storage, cookies and IndexedDB throw SecurityError) and the viewer's Content-Security-Policy enforced — on a 1280×800 desktop and a 390×844 phone, and reports script errors (with file:line:col), failed requests (with the code/hint of ShareOut API errors), blocked CDNs, accessibility (axe-core, WCAG 2.1 A/AA), horizontal overflow, tap targets under 44 px, broken images, blank screens, design lint, LCP/CLS/bytes and common source mistakes. Writes the page makes on load are refused (read-only render). The phone view renders the version's mobile entrypoint when it has one, and a pinned version is rendered entirely from that version's files. Verifying the live version also refreshes the thumbnail. Owners and editors only; workspace Agent tokens need artifacts:publish. Limited per user per hour (30 unless the instance sets VERIFY_RUNS_PER_HOUR). Without a Browser Rendering binding the result is partial (source checks only). Typical run: 5–15 s.

post/v1/artifacts/{id}/verify

Request

  • Base URL
    https://shareout.site
  • URL
    https://shareout.site/v1/artifacts/{id}/verify
  • Auth
    HTTP bearer

Request body

versioninteger

Version number to verify, with all of its files. Defaults to the live version.

viewportsstring[]

Defaults to both.

full_pageboolean

Screenshot the whole page height (up to 4000 px) instead of the first screen.

Response

The verify run (also stored as the latest)

idstring

Run id (vfy_…).

artifact_idstring
versioninteger
version_idstring
liveboolean

Whether the verified version is the one viewers get now.

status'pass' | 'warn' | 'fail' | 'partial'

fail = at least one error, warn = warnings only, pass = neither, partial = the page was not rendered (see partial_reason) and only the source was checked.

partial_reason'no_browser' | 'render_failed'
summarystring
designobject nullable

Fonts, accent colors, longest line and missing meta tags, from the first viewport.

thumbnail_refreshedboolean
duration_msinteger
created_atstring date-time

Changes