{"schema_version":"2026-06-13","provider":"OSPEA","auth":{"type":"bearer","workspace_scope":"workspace_id path parameter","permissions":"Workspace data endpoints require authenticated OSPEA access. Agents must act on behalf of an authorized workspace user.","note":"Read report endpoints before write actions. Mutations may consume provider credits or alter workspace tracking setup."},"policies":{"sandbox":"Use read-only report endpoints before write actions where available. Manual scans consume provider budget.","data_access":"Agents may only access workspace-scoped data authorized by the user.","mutation_receipts":"Write actions should persist audit metadata through OSPEA workspace records.","rate_limits":"Respect authenticated account limits, scan cadence, enabled providers, and provider budget approvals.","truthfulness":"Provider failures must be represented as scan_status error or timeout, not as ordinary zero-visibility answers.","first_party_data":"GSC and Bing AI Performance data must come from connected accounts or explicit exports; agents must not fabricate first-party metrics."},"trust":{"report_integrity":"AI visibility reports distinguish successful observations from failed provider attempts and expose model, latency, cost, citation, and source-class metadata where available.","citation_integrity":"Citation domains are normalized and classified as own-domain, competitor-owned, review, video, social-forum, directory, marketplace, earned-media, docs, unknown, or none.","deployment_note":"Production API endpoints require OSPEA authentication and workspace authorization."},"capability_boundaries":{"available_now":["workspace-scoped AI visibility share-of-voice reports","weekly AIO report and CSV/JSON export","SavedPrompt library and competitor tracking","manual visibility scans when provider credentials and budget are configured","Bing Webmaster Tools AI Performance export import","durable landing page creation, rendering, publishing, and view tracking"],"not_available_until_durable_storage":[{"surface":"editorial backlink marketplace","endpoints":["/backlinks/editorial/*"],"reason":"publisher, placement, attribution, and consent storage is not enabled"},{"surface":"managed link exchange workflows","endpoints":["/backlinks/exchange/sites","/backlinks/exchange/matches","/backlinks/exchange/initiate"],"reason":"exchange site, match, consent, and rate-limit storage is not enabled"},{"surface":"landing page form submissions","endpoints":["/landing-pages/{page_id}/submissions","/landing-pages/{page_id}/submit"],"reason":"durable lead submission storage is not enabled"},{"surface":"batch SERP scraping","endpoints":["/api/v1/serp/scrape/batch"],"reason":"durable job persistence and progress tracking are not enabled"},{"surface":"legacy onboarding website scan jobs","endpoints":["/workspaces/{workspace_id}/onboarding/scan","/workspaces/{workspace_id}/onboarding/scan/{job_id}"],"reason":"durable scan job storage and progress tracking are not enabled"}]},"not_supported":["unauthenticated access to private workspace reports","UI scraping as a substitute for official API/report endpoints","fabricated first-party GSC or Bing AI Performance metrics","unapproved provider-budget-consuming scans"]}