Docs
Analytics

Would this person see it?

POST/analytics/debug-audienceNeedsanalytics.view

Explains which published guidance a visitor would get on a URL and why each item would or wouldn't show (domain, URL, schedule, audience, frequency). Read-only: nothing is recorded.

Authorization

secretKey
headerAuthorizationBearer <sk_…>

A secret API key from Settings → API keys. It acts with its creator's role.

Request Body

application/json
  1. body
url*string
Length1 <= length <= 2048
userId?|number|null
traits?|null
locale?|null
environment?string
Default"production"
Value in"production""staging"
device?|null
timeZone?|null
content?

Response Body

OK

application/json
  1. response
context*
summary*
results*array<>
Shell
curl -X POST 'https://app.cueston.com/api/analytics/debug-audience' \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "https://app.acme.com/settings/billing"
}'
Example Response
JSON
{
  "context": {
    "url": "https://app.acme.com/settings/billing",
    "userId": "user-123",
    "locale": "de-DE",
    "environment": "production",
    "device": "string",
    "timeZone": "string",
    "identified": true,
    "evaluatedAt": "2026-10-26T09:30:00Z"
  },
  "summary": {
    "total": 3,
    "eligible": 0
  },
  "results": [
    {
      "contentType": "tour",
      "contentId": 42,
      "name": "Onboarding tour",
      "eligible": true,
      "reasons": [
        {
          "check": "domain",
          "passed": true,
          "detail": "string",
          "skipped": true,
          "ruleId": "string"
        }
      ]
    }
  ]
}