AI Visibility Overview

Role and auth requirements

• Primary roles: OWNER, OPERATOR
• Auth mode: JWT (Authorization: Bearer <token>)

UI flow (draft)

1. Open creator/admin dashboard for your handle.
2. Navigate to AI visibility and readiness controls.
3. Review crawler coverage, readiness score, and submission status.

API fallback (draft)

• GET /v2/handles/{handle}/site-intel/{hostname}/readiness-score
• POST /v2/handles/{handle}/site-intel/{hostname}/readiness-score
• POST /v2/handles/{handle}/site-intel/{hostname}/submit-urls
• POST /v2/handles/{handle}/site-intel/verify-bot

Failure and remediation (draft)

• 401 unauthorized: refresh session token and retry.
• 403 forbidden: confirm role access for the handle.
• 404 not_found: verify handle and hostname mapping.
• 429 rate_limited: retry with backoff and reduce request rate.