Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.trysight.ai/llms.txt

Use this file to discover all available pages before exploring further.

REST API (API keys)

Create keys in Integrations → Developers. Keys are shown once at creation.
curl -s https://app.trysight.ai/api/v1/sites \
  -H "Authorization: Bearer sai_YOUR_KEY_HERE"

Key format

  • Prefix: sai_
  • 64 hex characters after the prefix
  • Team-scoped; optional site restrictions at creation time

Scopes

ScopeAccess
analytics:readSearch + AI visibility analytics
opportunities:readAI + search content opportunities
articles:readList/get articles, limits
articles:writeCreate, edit, SEO refresh
agents:readAgents+ configs and runs
agents:writeToggle agents, trigger runs

MCP (OAuth only)

MCP clients must not use API keys. Use OAuth 2.1 Authorization Code + PKCE.
  • Authorization: GET /oauth/authorize
  • Token: POST /oauth/token
  • Metadata: GET /.well-known/oauth-authorization-server
Only team owners and admins can authorize MCP clients.

Errors

StatusMeaning
401Missing or invalid credentials
403Insufficient scope or unlicensed site
429Rate limit exceeded