API reference / Analytics
Check the managed proxy
Checks the managed proxy now. (The ticker also checks a pending proxy every 5 minutes.) It looks for the CNAME of the host to proxy.troopy.ai, then for the script over HTTPS. When both are there, the status is active.
post
/api/v1/analytics/proxy/checkOther ways to call it
CLI
troopy analytics proxy checkMCP toolNone. Call it over REST or with the CLI.
Rate limit10 calls in 60 seconds, for each key
Response
200 · application/jsondata*object1 properties
proxy*object | nullThe managed proxy: the script and events on a subdomain of the site, so ad blockers leave them alone
5 properties
host*stringThe subdomain of the site that serves the script, like a.acme.com
status*enum<string>pending until a check finds the CNAME and the script over HTTPS
pendingactivefailed
error*string | nullWhat the last check found missing
checkedAt*string | nulltarget*stringWhere the CNAME of the host points, like proxy.troopy.ai
Errors
401 unauthorizedSend an API key as `Authorization: Bearer tr_live_...`. Create one in Troopy under Settings.
403 forbiddenThe key lacks a scope this operation needs, or its owner lacks the role. detail says which; create a key with the scope, or ask an organization owner or admin.
429 rate_limitedWait the number of seconds in Retry-After, then retry.