GET
/sites/{siteId}/look-checksCheck 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 pathrequiredThe site id, from GET /v1/sites.
brandIdstringin queryoptionalCheck 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
okbooleanrequiredTrue when every check passes.
reasonstring | nullrequiredThe first failing check, in one sentence.
checksarray of objectrequiredchecks[].idstringrequiredOne of
readable,highlight,tcfchecks[].okbooleanrequiredchecks[].sentencestringrequiredsiteIdstringrequiredbrandNamestring | nullrequiredversionnumber | 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