All endpoints

DocsAPIAccount

POST/brands/review-links

Make a review link for a client

A link the client opens with no account.

Auth header

Authorization: Bearer tsk_live_…

The key needsbanner:write

Request body

  • brandIdstringrequired
  • versionintegeroptional
  • siteIdstringrequired

    The site whose homepage the client sees the version on.

Example request

curl -X POST "https://app.tagsentry.ai/api/v1/brands/review-links" \  -H "Authorization: Bearer tsk_live_…" \  -H "Content-Type: application/json" \  -d '{"brandId":"3f6c1b8e-2d4a-4c7e-9a51-0b8f2e6d7c10","version":1,"siteId":"3f6c1b8e-2d4a-4c7e-9a51-0b8f2e6d7c10"}'

Response 200

  • urlstringrequired

    Opens with no account. Approving records a name and publishes nothing.

  • expiresAtstringrequired
  • brandNamestringrequired
  • versionnumberrequired
  • siteIdstringrequired

Example response

{  "url": "https://silverpine.example/",  "expiresAt": "2026-09-26T14:02:00.000Z",  "brandName": "…",  "version": 0,  "siteId": "3f6c1b8e-2d4a-4c7e-9a51-0b8f2e6d7c10"}
More about this endpoint

It shows one brand version on one of their sites, in each place and on a phone, with Approve. Approving records the name they type and publishes nothing. The link expires after 14 days.

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