All endpoints

DocsAPISites

GET/sites/{siteId}/look-checks

Check a brand version on one site

The checks a brand version would run on this site before it is applied, or, with no brand named, the site's current look.

Auth header

Authorization: Bearer tsk_live_…

The key needssites:read

Parameters

  • siteIdstringin pathrequired

    The site id, from GET /v1/sites.

  • brandIdstringin queryoptional

    Check this brand's version on the site. Omitted: the site's current look.

  • versionintegerin queryoptional

Example request

curl "https://app.tagsentry.ai/api/v1/sites/3f6c1b8e-2d4a-4c7e-9a51-0b8f2e6d7c10/look-checks" \  -H "Authorization: Bearer tsk_live_…"

Response 200

  • okbooleanrequired

    True when every check passes.

  • reasonstring | nullrequired

    The first failing check, in one sentence.

  • checksarray of objectrequired
  • checks[].idstringrequired

    One of readable, highlight, tcf

  • checks[].okbooleanrequired
  • checks[].sentencestringrequired
  • siteIdstringrequired
  • brandNamestring | nullrequired
  • versionnumber | nullrequired

Example response

{  "ok": false,  "reason": "…",  "checks": [    {      "id": "readable",      "ok": false,      "sentence": "…"    }  ],  "siteId": "3f6c1b8e-2d4a-4c7e-9a51-0b8f2e6d7c10",  "brandName": "…",  "version": 0}
More about this endpoint

Changes nothing.

Errors400 · 401 · 403 · 404 · 429 · 500
  • 400The request did not validate against this operation's schema.
  • 401Missing, malformed, unknown, revoked or expired API key. These are deliberately indistinguishable in the response: distinguishing them would confirm to a caller that a token was once real.
  • 403The key authenticated but does not carry the scope(s) this operation requires, or (`domain_not_verified`) the site's domain is not verified, so its consent records are not released.
  • 404No such resource on this account. A site id belonging to a DIFFERENT account answers 404, never 403: a 403 would confirm the id exists somewhere.
  • 429A rate limit or quota was exceeded. The body names WHICH one.
  • 500Something failed on our side. The requestId in the body is what to quote.

Every error has the same body: { error: { code, message, requestId } }.

From the OpenAPI document, version 2026-08-26. Raw OpenAPI