# chatobserver > Learn AI visibility tracking, competitor analysis, sentiment, source citations, reporting, and the chatobserver API. - [How can I monitor and improve my brand’s AI visibility?](https://chatobserver.com/docs/index.md): Learn AI visibility tracking with chatobserver: set up prompts, analyse brand mentions and citations, compare competitors, and share reports. - [How do I track my brand in AI search?](https://chatobserver.com/docs/getting-started/ai-visibility-tracking.md): Set up AI visibility tracking for your brand, monitor relevant questions, and compare mentions, sentiment, and citations in chatobserver. - [How do I create an AI visibility workspace for my brand?](https://chatobserver.com/docs/getting-started/create-workspace.md): Set up a brand workspace with its name, primary domain, and organisation, and keep client monitoring separate. - [How do I add and run my first AI monitoring prompt?](https://chatobserver.com/docs/getting-started/first-prompt.md): Create your first prompt in chatobserver, select an AI platform and region, and open the collected answer. - [Which questions should I monitor for AI search visibility?](https://chatobserver.com/docs/getting-started/choose-prompts.md): Build a useful AI monitoring prompt set across discovery, comparisons, use cases, and branded questions. - [How do I choose AI platforms and regions for prompt tracking?](https://chatobserver.com/docs/getting-started/platforms-and-regions.md): Configure platform and region coverage for monitored prompts and compare AI answers within a consistent market. - [How do I schedule or pause AI visibility monitoring?](https://chatobserver.com/docs/getting-started/schedule-prompts.md): Choose a prompt monitoring schedule, time zone, and cadence, or pause a prompt without deleting it. - [How do I add multiple monitoring prompts at once?](https://chatobserver.com/docs/getting-started/bulk-import-prompts.md): Paste a list of questions or upload a CSV, review prompt defaults, and import a monitoring set into chatobserver. - [How do I read and compare AI answers in chatobserver?](https://chatobserver.com/docs/analysis/answer-history.md): Open a prompt's answer history and inspect the original answer, analysis, sentiment highlights, and source evidence. - [How do I use the AI visibility overview dashboard?](https://chatobserver.com/docs/analysis/overview.md): Read your workspace overview, check answer coverage, and move from AI visibility trends to the prompts behind them. - [What is the difference between AI visibility and share of voice?](https://chatobserver.com/docs/analysis/visibility-and-share-of-voice.md): Understand brand presence, ranking, and competitive share of voice in a monitored set of AI answers. - [How do I track competitors and brand aliases in AI answers?](https://chatobserver.com/docs/analysis/competitors.md): Configure competitor names and aliases, compare AI brand mentions, and investigate unexpected brand matching. - [How does AI brand sentiment analysis work in chatobserver?](https://chatobserver.com/docs/analysis/sentiment.md): Interpret positive, neutral, and negative brand sentiment, inspect highlighted passages, and compare competitor descriptions. - [How do I find which websites AI answers cite?](https://chatobserver.com/docs/analysis/source-citations.md): Analyse cited domains and pages, distinguish owned and third-party sources, and trace citations back to collected AI answers. - [How do I track products and sponsored placements in AI answers?](https://chatobserver.com/docs/analysis/shopping-visibility.md): Use Shopping Insights to inspect products, retailers, and sponsored placements captured in AI shopping answers. - [What are query fan-outs in AI search monitoring?](https://chatobserver.com/docs/analysis/query-fanouts.md): Understand related searches and expanded questions captured alongside monitored prompts, and use them to improve topic coverage. - [How do I organise AI monitoring prompts with groups and personas?](https://chatobserver.com/docs/workspace/groups-and-personas.md): Group prompts by topic and assign audience personas to keep your AI visibility research organised. - [How do I give my team access to a chatobserver workspace?](https://chatobserver.com/docs/workspace/members-and-permissions.md): Invite collaborators, understand organisation and workspace ownership, and manage access to brand data. - [How do I request early access to a chatobserver feature?](https://chatobserver.com/docs/workspace/early-access.md): Request a feature or platform for your workspace and understand pending, approved, and unavailable access states. - [How do I set up email alerts for AI visibility changes?](https://chatobserver.com/docs/workspace/alerts.md): Configure metric alerts for share of voice, brand mentions, and citations, and investigate the answers behind an alert. - [How do prompts and AI answer allowances work?](https://chatobserver.com/docs/workspace/usage-and-allowance.md): Understand the difference between stored prompts and collected answers, and manage your monitoring allowance. - [How do I manage my chatobserver subscription and billing?](https://chatobserver.com/docs/workspace/billing.md): Find your plan, invoices, payment settings, and cancellation controls, and understand billing ownership. - [How do I connect Claude or ChatGPT to chatobserver?](https://chatobserver.com/docs/developers/mcp.md): Connect an AI assistant to your chatobserver workspace, choose what it can access, and start asking questions about your visibility data. - [What can I do with Chatobserver in an AI assistant?](https://chatobserver.com/docs/mcp/capabilities.md): See every supported Chatobserver MCP workflow, what remains read-only, and which product areas are not yet available. - [How can an AI assistant manage prompts and answers?](https://chatobserver.com/docs/mcp/prompts-and-answers.md): Create, import, edit, run, archive and delete prompts, then analyse the answers and evidence they collect. - [How can an AI assistant organise prompts into groups?](https://chatobserver.com/docs/mcp/groups.md): Analyse groups, apply grouping opportunities, manage prompt membership, and preview or configure grouping rules safely. - [How can an AI assistant manage brands and competitors?](https://chatobserver.com/docs/mcp/competitors.md): Confirm your own brand, discover and review competitors, manage aliases, and compare performance with supporting evidence. - [How can an AI assistant analyse sources and sentiment?](https://chatobserver.com/docs/mcp/analysis.md): Explore cited domains and pages, export source activity, classify domains, and investigate sentiment with supporting quotations. - [How can an AI assistant analyse referrals and crawler activity?](https://chatobserver.com/docs/mcp/referrals-and-crawlers.md): Investigate existing AI referral traffic and crawler logs without exposing credentials or changing integrations. - [How can an AI assistant manage and measure Tracked coverage?](https://chatobserver.com/docs/mcp/tracked-coverage.md): Add published coverage, configure its details, prevent duplicates, preserve history, and measure exact-page citation evidence. - [How do permissions, allowance and approvals work?](https://chatobserver.com/docs/mcp/usage-and-safety.md): Choose workspaces safely, understand read and change permissions, check remaining capacity, and revoke access. - [What should I ask the Chatobserver connector to do?](https://chatobserver.com/docs/mcp/example-requests.md): Copy practical requests for prompt setup, CSV review, grouping, competitor research, evidence analysis and workspace housekeeping. - [Why is the Chatobserver connector not doing what I expect?](https://chatobserver.com/docs/mcp/troubleshooting.md): Resolve missing workspaces, permissions, reconnect requests, unsupported actions, confusing approvals and incomplete results. - [How can my assistant compose and assess a report?](https://chatobserver.com/docs/mcp/reports.md): Create and save editable reports, publish a shared link, and request layout assessment when needed. - [How can my assistant prepare reusable Data queries?](https://chatobserver.com/docs/mcp/data.md): Inspect existing connectors, author saved query versions and explicitly request execution independently of reports. - [How do I create an AI visibility report in chatobserver?](https://chatobserver.com/docs/reports/create-report.md): Build an AI visibility report from a template or blank canvas, connect workspace data, and prepare it for sharing. - [How do I publish and share an AI visibility report?](https://chatobserver.com/docs/reports/share-report.md): Publish a report snapshot, choose link permissions, control downloads, and update or revoke shared access. - [How do I download an AI visibility report as a PDF?](https://chatobserver.com/docs/reports/download-pdf.md): Download a published report as a PDF and understand link permissions, versioning, and unavailable downloads. - [How do I connect marketing data to chatobserver?](https://chatobserver.com/docs/data/connect-data.md): Connect marketing accounts, choose the right data source, and use connected results alongside AI visibility reporting. - [How do I build reusable marketing data queries?](https://chatobserver.com/docs/data/queries.md): Select fields, date ranges, and filters in Data, preview a query, and reuse its results in reports. - [How do I schedule data refreshes and deliver query results?](https://chatobserver.com/docs/data/schedules-and-delivery.md): Schedule saved queries, review upcoming runs, and deliver completed marketing data results to configured destinations. - [How do I track website visits from AI assistants?](https://chatobserver.com/docs/data/ai-referrals.md): Use AI Referrals to analyse visits attributed to AI sources and distinguish referral traffic from answer visibility. - [How do I see when AI crawlers visit my website?](https://chatobserver.com/docs/data/crawler-logs.md): Connect crawler logs and inspect AI bot requests, visited pages, response statuses, and activity trends. - [Why is my AI monitoring prompt missing an answer?](https://chatobserver.com/docs/troubleshooting/missing-answers.md): Check prompt status, schedule, platform access, allowance, and answer analysis when a result has not appeared. - [Why is my brand missing from an AI answer or visibility report?](https://chatobserver.com/docs/troubleshooting/missing-brand.md): Distinguish an absent brand from a matching issue, a filtered result, or pending analysis in AI visibility tracking. - [Why are sentiment highlights missing or unexpected?](https://chatobserver.com/docs/troubleshooting/sentiment-highlights.md): Check brand matching, analysis status, and competitor highlighting when an AI answer's sentiment does not look right. - [Why can I sign in but not open my workspace?](https://chatobserver.com/docs/troubleshooting/sign-in-and-access.md): Resolve account, invitation, and workspace-access mismatches without creating duplicate accounts. - [How do I authenticate with the chatobserver API?](https://chatobserver.com/docs/developers/authentication.md): Create a workspace API key, send authentication headers, validate access, and choose the right permissions for an integration. - [How do I paginate and filter chatobserver API results?](https://chatobserver.com/docs/developers/pagination-and-filters.md): Use opaque cursors, date filters, and endpoint-specific page sizes for visibility and Data API collections. - [How do I handle chatobserver API errors and rate limits?](https://chatobserver.com/docs/developers/errors-and-rate-limits.md): Interpret authentication, validation, conflict, and rate-limit responses, and retry API requests safely. - [How do I safely retry API requests that change data?](https://chatobserver.com/docs/developers/safe-writes.md): Use idempotency keys where supported, handle conflicting requests, and avoid duplicate prompt runs or Data API commands. - [How do I create and run AI monitoring prompts through the API?](https://chatobserver.com/docs/developers/manage-prompts.md): Create a monitoring prompt, configure its platforms and schedule, request an answer, and follow the resulting response history. - [How do I export AI answers, sentiment, and citations through the API?](https://chatobserver.com/docs/developers/export-answers.md): Retrieve response history, filter by prompt and platform, and export answer details and citation analytics for reporting. - [How do I use the chatobserver Data API?](https://chatobserver.com/docs/developers/data-api.md): Use service-account credentials to access connected data, versioned queries, schedules, transfers, and results. - [How do I follow Data API operations and receive webhooks?](https://chatobserver.com/docs/developers/data-operations.md): Track accepted Data API operations, retrieve results, verify signed webhook requests, and handle duplicate events. - [How do I generate AI visibility reports through the API?](https://chatobserver.com/docs/developers/website-audits.md): Create website audits with a workspace API key or an origin-restricted embed key, then retrieve the resulting report link. - [How do I authorise a spreadsheet client to use chatobserver data?](https://chatobserver.com/docs/developers/spreadsheet-authorisation.md): Use the document-bound authorisation flow for Google Sheets and Excel clients without exposing workspace API keys. - [How do I version and publish reusable Data API definitions?](https://chatobserver.com/docs/developers/definitions-and-versions.md): Create reusable data definitions, preserve immutable versions, and publish explicit versions for queries, schedules and integrations. - [How do I validate API access and find my workspace project?](https://chatobserver.com/docs/api-reference/workspace.md): Validate access and list the workspace project and available platforms. - [List AI platforms](https://chatobserver.com/docs/api-reference/workspace/get-v2-models.md): Validate access and list the workspace project and available platforms. - [List workspace projects](https://chatobserver.com/docs/api-reference/workspace/get-v2-projects.md): Validate access and list the workspace project and available platforms. - [Validate API access](https://chatobserver.com/docs/api-reference/workspace/get-v2-validate.md): Validate access and list the workspace project and available platforms. - [Get domain visibility totals](https://chatobserver.com/docs/api-reference/workspace/get-v2-visibility-domain-rollups.md): Validate access and list the workspace project and available platforms. - [How do I manage AI tracking prompts through the API?](https://chatobserver.com/docs/api-reference/prompts.md): Create, schedule, organise, activate and retrieve tracked prompts. - [List personas](https://chatobserver.com/docs/api-reference/prompts/get-v2-personas.md): Create, schedule, organise, activate and retrieve tracked prompts. - [Create a persona](https://chatobserver.com/docs/api-reference/prompts/post-v2-personas.md): Create, schedule, organise, activate and retrieve tracked prompts. - [List monitoring prompts](https://chatobserver.com/docs/api-reference/prompts/get-v2-prompts.md): Create, schedule, organise, activate and retrieve tracked prompts. - [Create a monitoring prompt](https://chatobserver.com/docs/api-reference/prompts/post-v2-prompts.md): Create a monitoring question with its platforms, regions, groups, and schedule. Delegated MCP connections require prompts:read and prompts:create, plus an Idempotency-Key. Current membership and workspace permissions are checked on every request. - [List prompt groups](https://chatobserver.com/docs/api-reference/prompts/get-v2-tags.md): Create, schedule, organise, activate and retrieve tracked prompts. - [Create a prompt group](https://chatobserver.com/docs/api-reference/prompts/post-v2-tags.md): Create, schedule, organise, activate and retrieve tracked prompts. - [Get a persona](https://chatobserver.com/docs/api-reference/prompts/get-v2-personas-id.md): Create, schedule, organise, activate and retrieve tracked prompts. - [Update a persona](https://chatobserver.com/docs/api-reference/prompts/put-v2-personas-id.md): Create, schedule, organise, activate and retrieve tracked prompts. - [Delete a persona](https://chatobserver.com/docs/api-reference/prompts/delete-v2-personas-id.md): Create, schedule, organise, activate and retrieve tracked prompts. - [Get a monitoring prompt](https://chatobserver.com/docs/api-reference/prompts/get-v2-prompts-id.md): Create, schedule, organise, activate and retrieve tracked prompts. - [Update a monitoring prompt](https://chatobserver.com/docs/api-reference/prompts/put-v2-prompts-id.md): Create, schedule, organise, activate and retrieve tracked prompts. - [Delete a monitoring prompt](https://chatobserver.com/docs/api-reference/prompts/delete-v2-prompts-id.md): Create, schedule, organise, activate and retrieve tracked prompts. - [Activate monitoring prompts](https://chatobserver.com/docs/api-reference/prompts/patch-v2-prompts-activate.md): Create, schedule, organise, activate and retrieve tracked prompts. - [Create multiple monitoring prompts](https://chatobserver.com/docs/api-reference/prompts/post-v2-prompts-bulk.md): Create, schedule, organise, activate and retrieve tracked prompts. - [Delete multiple monitoring prompts](https://chatobserver.com/docs/api-reference/prompts/delete-v2-prompts-bulk.md): Create, schedule, organise, activate and retrieve tracked prompts. - [Pause monitoring prompts](https://chatobserver.com/docs/api-reference/prompts/patch-v2-prompts-deactivate.md): Create, schedule, organise, activate and retrieve tracked prompts. - [Update a prompt group](https://chatobserver.com/docs/api-reference/prompts/patch-v2-tags-id.md): Create, schedule, organise, activate and retrieve tracked prompts. - [Delete a prompt group](https://chatobserver.com/docs/api-reference/prompts/delete-v2-tags-id.md): Create, schedule, organise, activate and retrieve tracked prompts. - [Run a prompt now](https://chatobserver.com/docs/api-reference/prompts/post-v2-prompts-id-rerun.md): Queue one manual run through the same workspace execution policy as the dashboard. An optional Idempotency-Key retains the successful response for 24 hours; reusing it returns that response without another execution request, including after the original run completes. The execution request and retry… - [Assign groups to a prompt](https://chatobserver.com/docs/api-reference/prompts/post-v2-prompts-id-tags.md): Create, schedule, organise, activate and retrieve tracked prompts. - [Assign groups to multiple prompts](https://chatobserver.com/docs/api-reference/prompts/post-v2-prompts-tags-bulk.md): Create, schedule, organise, activate and retrieve tracked prompts. - [List prompt groups](https://chatobserver.com/docs/api-reference/prompts/get-v2-groups.md): Returns current workspace group information. Archived groups remain available for review and restoration. - [Create a prompt group](https://chatobserver.com/docs/api-reference/prompts/post-v2-groups.md): Requires write scope. Delegated users must currently be workspace owners or admins. Editing requires the revision returned by a fresh group read; conflicts return 409. Archive rather than permanently delete groups. Successful keyed changes are safe to retry. - [Read a prompt group](https://chatobserver.com/docs/api-reference/prompts/get-v2-groups-id.md): Returns current workspace group information. Archived groups remain available for review and restoration. - [Edit or archive a prompt group](https://chatobserver.com/docs/api-reference/prompts/patch-v2-groups-id.md): Requires write scope. Delegated users must currently be workspace owners or admins. Editing requires the revision returned by a fresh group read; conflicts return 409. Archive rather than permanently delete groups. Successful keyed changes are safe to retry. - [Change prompt group membership](https://chatobserver.com/docs/api-reference/prompts/patch-v2-groups-id-memberships.md): Requires write scope. Delegated users must currently be workspace owners or admins. Editing requires the revision returned by a fresh group read; conflicts return 409. Archive rather than permanently delete groups. Successful keyed changes are safe to retry. - [Archive monitoring prompts](https://chatobserver.com/docs/api-reference/prompts/patch-v2-prompts-archive.md): Change the archived state of up to 200 prompts atomically, preserving historical records. The archived state of answers follows the prompt. - [Unarchive monitoring prompts](https://chatobserver.com/docs/api-reference/prompts/patch-v2-prompts-unarchive.md): Change the archived state of up to 200 prompts atomically, preserving historical records. The archived state of answers follows the prompt. - [Read group comparisons and grouping opportunities](https://chatobserver.com/docs/api-reference/prompts/get-v2-groups-overview.md): Read analytics for the authenticated workspace. Requires group feature access and groups:read for MCP. Use section and page to traverse a group detail table. Supported comparison windows: 7, 30 and 90 days. - [Read group visibility, sources and evidence](https://chatobserver.com/docs/api-reference/prompts/get-v2-groups-id-analytics.md): Read analytics for the authenticated workspace. Requires group feature access and groups:read for MCP. Use section and page to traverse a group detail table. Supported comparison windows: 7, 30 and 90 days. - [List grouping rules](https://chatobserver.com/docs/api-reference/prompts/get-v2-groups-rules.md): Rules use the same workspace group permissions and reconciliation process as the application. Preview before creating or changing matching criteria. Creation requires the preview fingerprint; edits and archive require the current version. Conflicts require rereading or previewing, not blindly retryi… - [Create a reviewed grouping rule](https://chatobserver.com/docs/api-reference/prompts/post-v2-groups-rules.md): Rules use the same workspace group permissions and reconciliation process as the application. Preview before creating or changing matching criteria. Creation requires the preview fingerprint; edits and archive require the current version. Conflicts require rereading or previewing, not blindly retryi… - [Preview a grouping rule](https://chatobserver.com/docs/api-reference/prompts/post-v2-groups-rules-preview.md): Rules use the same workspace group permissions and reconciliation process as the application. Preview before creating or changing matching criteria. Creation requires the preview fingerprint; edits and archive require the current version. Conflicts require rereading or previewing, not blindly retryi… - [Edit or pause a grouping rule](https://chatobserver.com/docs/api-reference/prompts/patch-v2-groups-rules-rule-id.md): Rules use the same workspace group permissions and reconciliation process as the application. Preview before creating or changing matching criteria. Creation requires the preview fingerprint; edits and archive require the current version. Conflicts require rereading or previewing, not blindly retryi… - [Archive a grouping rule](https://chatobserver.com/docs/api-reference/prompts/post-v2-groups-rules-rule-id-archive.md): Rules use the same workspace group permissions and reconciliation process as the application. Preview before creating or changing matching criteria. Creation requires the preview fingerprint; edits and archive require the current version. Conflicts require rereading or previewing, not blindly retryi… - [Read prompt visibility and comparisons](https://chatobserver.com/docs/api-reference/prompts/get-v2-prompts-id-analytics.md): Workspace-scoped app capability through the customer API. MCP requires the matching prompts or competitors permission. Competitor writes require current admin permission. Personal review sessions additionally require user-authorized OAuth and are unavailable to workspace service keys. Identity decis… - [Read prompt source popularity](https://chatobserver.com/docs/api-reference/prompts/get-v2-prompts-popularity.md): Workspace-scoped app capability through the customer API. MCP requires the matching prompts or competitors permission. Competitor writes require current admin permission. Personal review sessions additionally require user-authorized OAuth and are unavailable to workspace service keys. Identity decis… - [Read your prompt drafts](https://chatobserver.com/docs/api-reference/prompts/get-v2-prompts-drafts.md): Same workspace feature and role permissions as the app. Writes commit their successful retry receipt atomically. Personal drafts require user-authorized OAuth; service API keys cannot access a member’s drafts. New saves use null ID and revision; updates/removal require the current revision. Multiple… - [Save a personal prompt draft](https://chatobserver.com/docs/api-reference/prompts/put-v2-prompts-drafts.md): Same workspace feature and role permissions as the app. Writes commit their successful retry receipt atomically. Personal drafts require user-authorized OAuth; service API keys cannot access a member’s drafts. New saves use null ID and revision; updates/removal require the current revision. Multiple… - [Remove a personal prompt draft](https://chatobserver.com/docs/api-reference/prompts/delete-v2-prompts-drafts.md): Same workspace feature and role permissions as the app. Writes commit their successful retry receipt atomically. Personal drafts require user-authorized OAuth; service API keys cannot access a member’s drafts. New saves use null ID and revision; updates/removal require the current revision. Multiple… - [Read the filtered prompt inventory](https://chatobserver.com/docs/api-reference/prompts/get-v2-prompts-inventory.md): Same workspace feature and role permissions as the app. Writes commit their successful retry receipt atomically. List filters use comma-separated values. Follow nextCursor or previousCursor with navigationDirection to paginate. Rows contain numeric prompt, group and persona IDs. Applied state report… - [Apply or dismiss a grouping opportunity](https://chatobserver.com/docs/api-reference/prompts/post-v2-groups-opportunities.md): Same workspace feature and role permissions as the app. Writes commit their successful retry receipt atomically. Read the group overview first. Creating requires a name, reuses an existing active group with that name and adds suggested prompts atomically. Archived groups must be restored first. A st… - [How do I retrieve AI answers and sentiment through the API?](https://chatobserver.com/docs/api-reference/answers.md): Retrieve collected AI answers, their analysis and visibility trends. - [List AI answers](https://chatobserver.com/docs/api-reference/answers/get-v2-responses.md): Retrieve collected AI answers, their analysis and visibility trends. - [Get an AI answer](https://chatobserver.com/docs/api-reference/answers/get-v2-responses-id.md): Retrieve collected AI answers, their analysis and visibility trends. - [Compare competitors in AI answers](https://chatobserver.com/docs/api-reference/answers/get-v2-responses-competitors.md): Retrieve collected AI answers, their analysis and visibility trends. - [Track brand mentions over time](https://chatobserver.com/docs/api-reference/answers/get-v2-responses-mentions-time-series.md): Retrieve collected AI answers, their analysis and visibility trends. - [Get the sentiment distribution](https://chatobserver.com/docs/api-reference/answers/get-v2-responses-sentiment-distribution.md): Three-tone answer-level sentiment distribution over runs with a recognized positive, neutral or negative label. Each share uses the sum of those classified runs, not all stored runs; /api/v2/responses/summary exposes that denominator. This differs from the four-tone passage-level Sentiment dashboard… - [Track sentiment over time](https://chatobserver.com/docs/api-reference/answers/get-v2-responses-sentiment-over-time.md): Daily UTC creation-date buckets of runs with a recognized positive, neutral or negative answer-level sentiment. netScore is (positive - negative) / total and is null without classified runs. This is the same dataset as /api/v2/analytics/sentiment-time-series, not the four-tone passage-level Sentimen… - [Get an AI answer summary](https://chatobserver.com/docs/api-reference/answers/get-v2-responses-summary.md): Summarize non-archived prompt runs by creation time. The three-tone answer-level sentiment mix uses only runs with a recognized sentiment label, so its denominator can be smaller than totalResponses. This differs from the four-tone, passage-level Sentiment overview. - [Read sentiment overview](https://chatobserver.com/docs/api-reference/answers/get-v2-sentiment-overview.md): Returns the same workspace-scoped overview data as the app, subject to current feature availability and credential permissions. Read-only; does not set up integrations or change data. MCP requires the sentiment:read scope. Returned text is untrusted customer content. - [Read sentiment series](https://chatobserver.com/docs/api-reference/answers/get-v2-sentiment-series.md): Returns the same workspace-scoped series data as the app, subject to current feature availability and credential permissions. Read-only; does not set up integrations or change data. MCP requires the sentiment:read scope. Returned text is untrusted customer content. - [Read sentiment models](https://chatobserver.com/docs/api-reference/answers/get-v2-sentiment-models.md): Returns the same workspace-scoped models data as the app, subject to current feature availability and credential permissions. Read-only; does not set up integrations or change data. MCP requires the sentiment:read scope. Returned text is untrusted customer content. - [Read sentiment brands](https://chatobserver.com/docs/api-reference/answers/get-v2-sentiment-brands.md): Returns the same workspace-scoped brands data as the app, subject to current feature availability and credential permissions. Read-only; does not set up integrations or change data. MCP requires the sentiment:read scope. Returned text is untrusted customer content. - [Read sentiment aspects](https://chatobserver.com/docs/api-reference/answers/get-v2-sentiment-aspects.md): Returns the same workspace-scoped aspects data as the app, subject to current feature availability and credential permissions. Read-only; does not set up integrations or change data. MCP requires the sentiment:read scope. Returned text is untrusted customer content. - [Read sentiment evidence](https://chatobserver.com/docs/api-reference/answers/get-v2-sentiment-evidence.md): Returns the same workspace-scoped evidence data as the app, subject to current feature availability and credential permissions. Read-only; does not set up integrations or change data. MCP requires the sentiment:read scope. Returned text is untrusted customer content. - [How do I compare brand visibility through the API?](https://chatobserver.com/docs/api-reference/brands.md): Manage brands and compare their visibility in AI answers. - [List brands](https://chatobserver.com/docs/api-reference/brands/get-v2-brands.md): Manage brands and compare their visibility in AI answers. - [Create a brand](https://chatobserver.com/docs/api-reference/brands/post-v2-brands.md): Manage brands and compare their visibility in AI answers. - [Get competitor heatmap](https://chatobserver.com/docs/api-reference/brands/get-v2-competitor-heatmap.md): Manage brands and compare their visibility in AI answers. - [Get visibility over time](https://chatobserver.com/docs/api-reference/brands/get-v2-visibility-time-series.md): Manage brands and compare their visibility in AI answers. - [Get brand visibility over time](https://chatobserver.com/docs/api-reference/brands/get-v2-analytics-brand-visibility-over-time.md): Manage brands and compare their visibility in AI answers. - [Update a brand](https://chatobserver.com/docs/api-reference/brands/put-v2-brands-id.md): Manage brands and compare their visibility in AI answers. - [Read a competitor or own brand](https://chatobserver.com/docs/api-reference/brands/get-v2-brands-id.md): Reads the current workspace only, subject to current product access. MCP requires the matching sources or competitors read permission. - [Get a share of voice comparison](https://chatobserver.com/docs/api-reference/brands/get-v2-share-of-voice-comparison.md): Manage brands and compare their visibility in AI answers. - [Get share of voice over time](https://chatobserver.com/docs/api-reference/brands/get-v2-share-of-voice-time-series.md): Manage brands and compare their visibility in AI answers. - [List brand name and domain aliases](https://chatobserver.com/docs/api-reference/brands/get-v2-brands-id-aliases.md): Reads the current workspace only, subject to current product access. MCP requires the matching sources or competitors read permission. - [Add a brand alias](https://chatobserver.com/docs/api-reference/brands/post-v2-brands-id-aliases.md): Requires read and write API scopes; MCP users also need the matching consented write permission and current workspace admin role. Source profile updates replace optional tracking, target URL and notes with their defaults when omitted. Alias changes update historical attribution atomically. - [Remove a brand alias](https://chatobserver.com/docs/api-reference/brands/delete-v2-brands-id-aliases-alias-id.md): Requires read and write API scopes; MCP users also need the matching consented write permission and current workspace admin role. Source profile updates replace optional tracking, target URL and notes with their defaults when omitted. Alias changes update historical attribution atomically. - [Discover competitor identities](https://chatobserver.com/docs/api-reference/brands/get-v2-brands-suggestions.md): Workspace-scoped app capability through the customer API. MCP requires the matching prompts or competitors permission. Competitor writes require current admin permission. Personal review sessions additionally require user-authorized OAuth and are unavailable to workspace service keys. Identity decis… - [Compare competitor visibility](https://chatobserver.com/docs/api-reference/brands/get-v2-brands-metrics.md): Workspace-scoped app capability through the customer API. MCP requires the matching prompts or competitors permission. Competitor writes require current admin permission. Personal review sessions additionally require user-authorized OAuth and are unavailable to workspace service keys. Identity decis… - [Compare competitor answer positions](https://chatobserver.com/docs/api-reference/brands/get-v2-brands-positions.md): Workspace-scoped app capability through the customer API. MCP requires the matching prompts or competitors permission. Competitor writes require current admin permission. Personal review sessions additionally require user-authorized OAuth and are unavailable to workspace service keys. Identity decis… - [Read competitor evidence and analytics](https://chatobserver.com/docs/api-reference/brands/get-v2-brands-id-analytics.md): Workspace-scoped app capability through the customer API. MCP requires the matching prompts or competitors permission. Competitor writes require current admin permission. Personal review sessions additionally require user-authorized OAuth and are unavailable to workspace service keys. Identity decis… - [Resolve a discovered competitor identity](https://chatobserver.com/docs/api-reference/brands/post-v2-brands-decisions.md): Workspace-scoped app capability through the customer API. MCP requires the matching prompts or competitors permission. Competitor writes require current admin permission. Personal review sessions additionally require user-authorized OAuth and are unavailable to workspace service keys. Identity decis… - [Start or resume a personal competitor review](https://chatobserver.com/docs/api-reference/brands/post-v2-brands-reviews.md): Workspace-scoped app capability through the customer API. MCP requires the matching prompts or competitors permission. Competitor writes require current admin permission. Personal review sessions additionally require user-authorized OAuth and are unavailable to workspace service keys. Identity decis… - [Read your competitor review](https://chatobserver.com/docs/api-reference/brands/get-v2-brands-reviews-session-id.md): Workspace-scoped app capability through the customer API. MCP requires the matching prompts or competitors permission. Competitor writes require current admin permission. Personal review sessions additionally require user-authorized OAuth and are unavailable to workspace service keys. Identity decis… - [Stage competitor review decisions](https://chatobserver.com/docs/api-reference/brands/patch-v2-brands-reviews-session-id.md): Workspace-scoped app capability through the customer API. MCP requires the matching prompts or competitors permission. Competitor writes require current admin permission. Personal review sessions additionally require user-authorized OAuth and are unavailable to workspace service keys. Identity decis… - [Apply reviewed competitor decisions](https://chatobserver.com/docs/api-reference/brands/post-v2-brands-reviews-session-id-apply.md): Workspace-scoped app capability through the customer API. MCP requires the matching prompts or competitors permission. Competitor writes require current admin permission. Personal review sessions additionally require user-authorized OAuth and are unavailable to workspace service keys. Identity decis… - [Read the workspace brand](https://chatobserver.com/docs/api-reference/brands/get-v2-brands-own-brand.md): Same workspace feature and role permissions as the app. Writes commit their successful retry receipt atomically. - [Configure and confirm the workspace brand](https://chatobserver.com/docs/api-reference/brands/put-v2-brands-own-brand.md): Same workspace feature and role permissions as the app. Writes commit their successful retry receipt atomically. - [Confirm the existing workspace brand](https://chatobserver.com/docs/api-reference/brands/post-v2-brands-own-brand-confirm.md): Same workspace feature and role permissions as the app. Writes commit their successful retry receipt atomically. Acknowledges the existing identity without editing it. Every current workspace member can confirm; MCP requires the separate competitors:confirm permission. Configuring the identity requi… - [How do I retrieve AI citations and source domains through the API?](https://chatobserver.com/docs/api-reference/sources-and-citations.md): Analyse cited domains, pages and ownership across answers. - [Get citation analytics](https://chatobserver.com/docs/api-reference/sources-and-citations/get-v2-citations-analytics.md): Analyse cited domains, pages and ownership across answers. - [Analyse citation positions](https://chatobserver.com/docs/api-reference/sources-and-citations/get-v2-citations-citation-rank-analysis.md): Analyse cited domains, pages and ownership across answers. - [Track domain citations over time](https://chatobserver.com/docs/api-reference/sources-and-citations/get-v2-citations-domain-citations-over-time.md): Analyse cited domains, pages and ownership across answers. - [Compare cited domains by AI platform](https://chatobserver.com/docs/api-reference/sources-and-citations/get-v2-citations-domains-by-llm.md): Analyse cited domains, pages and ownership across answers. - [Compare sources by AI platform](https://chatobserver.com/docs/api-reference/sources-and-citations/get-v2-citations-llm-sources.md): Analyse cited domains, pages and ownership across answers. - [Measure citations to your own domain](https://chatobserver.com/docs/api-reference/sources-and-citations/get-v2-citations-self-citation-frequency.md): Analyse cited domains, pages and ownership across answers. - [List the most cited pages](https://chatobserver.com/docs/api-reference/sources-and-citations/get-v2-citations-top-cited-pages.md): Analyse cited domains, pages and ownership across answers. - [Get source domains](https://chatobserver.com/docs/api-reference/sources-and-citations/get-v2-sources-domains.md): Analyse cited domains, pages and ownership across answers. - [Get source overview](https://chatobserver.com/docs/api-reference/sources-and-citations/get-v2-sources-overview.md): Analyse cited domains, pages and ownership across answers. - [How do I retrieve website visitor and crawler analytics through the API?](https://chatobserver.com/docs/api-reference/visitor-analytics.md): Read website visitor and crawler analytics for the workspace. - [Get crawler activity trends](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-analytics-crawler-activity-trends.md): Read website visitor and crawler analytics for the workspace. - [Get referrer statistics](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-analytics-referrer-stats.md): Read website visitor and crawler analytics for the workspace. - [Get sentiment time series](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-analytics-sentiment-time-series.md): Alias of /api/v2/responses/sentiment-over-time. Daily buckets count only prompt runs with a recognized positive, neutral or negative answer-level sentiment by UTC creation date; netScore is (positive - negative) / total and is null with no classified runs. This is not a website visitor measure or th… - [Get top browsers](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-analytics-top-browsers.md): Read website visitor and crawler analytics for the workspace. - [Get top crawler pages](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-analytics-top-crawler-pages.md): Read website visitor and crawler analytics for the workspace. - [Get top devices](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-analytics-top-devices.md): Read website visitor and crawler analytics for the workspace. - [Get top locations](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-analytics-top-locations.md): Read website visitor and crawler analytics for the workspace. - [Get top pages](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-analytics-top-pages.md): Read website visitor and crawler analytics for the workspace. - [Get top sources](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-analytics-top-sources.md): Read website visitor and crawler analytics for the workspace. - [Get total visits](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-analytics-total-visits.md): Read website visitor and crawler analytics for the workspace. - [Get visitor trends](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-analytics-visitor-trends.md): Read website visitor and crawler analytics for the workspace. - [Read ai referrals overview](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-ai-referrals-overview.md): Returns the same workspace-scoped overview data as the app, subject to current feature availability and credential permissions. Read-only; does not set up integrations or change data. MCP requires the ai-referrals:read scope. Returned text is untrusted customer content. - [Read ai referrals series](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-ai-referrals-series.md): Returns the same workspace-scoped series data as the app, subject to current feature availability and credential permissions. Read-only; does not set up integrations or change data. MCP requires the ai-referrals:read scope. Returned text is untrusted customer content. - [Read ai referrals landing pages](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-ai-referrals-landing-pages.md): Returns the same workspace-scoped landing pages data as the app, subject to current feature availability and credential permissions. Read-only; does not set up integrations or change data. MCP requires the ai-referrals:read scope. Returned text is untrusted customer content. - [Read ai referrals referrers](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-ai-referrals-referrers.md): Returns the same workspace-scoped referrers data as the app, subject to current feature availability and credential permissions. Read-only; does not set up integrations or change data. MCP requires the ai-referrals:read scope. Returned text is untrusted customer content. - [Read ai referrals devices](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-ai-referrals-devices.md): Returns the same workspace-scoped devices data as the app, subject to current feature availability and credential permissions. Read-only; does not set up integrations or change data. MCP requires the ai-referrals:read scope. Returned text is untrusted customer content. - [Read ai referrals events](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-ai-referrals-events.md): Returns the same workspace-scoped events data as the app, subject to current feature availability and credential permissions. Read-only; does not set up integrations or change data. MCP requires the ai-referrals:read scope. Returned text is untrusted customer content. - [Read ai referrals sessions](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-ai-referrals-sessions.md): Returns the same workspace-scoped sessions data as the app, subject to current feature availability and credential permissions. Read-only; does not set up integrations or change data. MCP requires the ai-referrals:read scope. Returned text is untrusted customer content. - [Read crawler logs overview](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-crawler-logs-overview.md): Returns the same workspace-scoped overview data as the app, subject to current feature availability and credential permissions. Read-only; does not set up integrations or change data. MCP requires the crawler-logs:read scope. Returned text is untrusted customer content. - [Read crawler logs chart series](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-crawler-logs-chart-series.md): Returns the same workspace-scoped chart series data as the app, subject to current feature availability and credential permissions. Read-only; does not set up integrations or change data. MCP requires the crawler-logs:read scope. Returned text is untrusted customer content. - [Read crawler logs top pages](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-crawler-logs-top-pages.md): Returns the same workspace-scoped top pages data as the app, subject to current feature availability and credential permissions. Read-only; does not set up integrations or change data. MCP requires the crawler-logs:read scope. Returned text is untrusted customer content. - [Read crawler logs top crawlers](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-crawler-logs-top-crawlers.md): Returns the same workspace-scoped top crawlers data as the app, subject to current feature availability and credential permissions. Read-only; does not set up integrations or change data. MCP requires the crawler-logs:read scope. Returned text is untrusted customer content. - [Read crawler logs events](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-crawler-logs-events.md): Returns the same workspace-scoped events data as the app, subject to current feature availability and credential permissions. Read-only; does not set up integrations or change data. MCP requires the crawler-logs:read scope. Returned text is untrusted customer content. - [Export crawler events as CSV](https://chatobserver.com/docs/api-reference/visitor-analytics/get-v2-crawler-logs-events-export.md): Read-only export. The JSON response contains filename, text/csv mimeType, CSV content and rowCount; save content as the named file. Uses the same workspace filters and permissions as the app. Source exports allow at most 365 days and 10,000 output rows. Crawler exports return up to the requested 5,0… - [How do I retrieve AI content gaps and query fanouts through the API?](https://chatobserver.com/docs/api-reference/content-opportunities.md): Retrieve content-gap findings and recommendations for tracked prompts. - [List query fan-outs](https://chatobserver.com/docs/api-reference/content-opportunities/get-v2-query-fanouts.md): Retrieve content-gap findings and recommendations for tracked prompts. - [List prompt content gaps](https://chatobserver.com/docs/api-reference/content-opportunities/get-v2-content-gap-prompts.md): Retrieve content-gap findings and recommendations for tracked prompts. - [Get content gap statistics](https://chatobserver.com/docs/api-reference/content-opportunities/get-v2-content-gap-stats.md): Retrieve content-gap findings and recommendations for tracked prompts. - [Get the latest content gap analysis](https://chatobserver.com/docs/api-reference/content-opportunities/get-v2-content-gap-prompts-prompt-id-latest.md): Retrieve content-gap findings and recommendations for tracked prompts. - [Read content gap recommendations](https://chatobserver.com/docs/api-reference/content-opportunities/get-v2-content-gap-prompts-prompt-id-latest-recommendations.md): Retrieve content-gap findings and recommendations for tracked prompts. - [How do I check AI answer usage through the API?](https://chatobserver.com/docs/api-reference/usage.md): Read workspace consumption and allowance summaries. - [Get answer allowance usage](https://chatobserver.com/docs/api-reference/usage/get-v2-usage-summary.md): Read workspace consumption and allowance summaries. - [How do I discover Data API connections and source catalogues?](https://chatobserver.com/docs/api-reference/data-connections.md): Discover authorised connections, source accounts and connector catalogues. - [List source account tags](https://chatobserver.com/docs/api-reference/data-connections/get-v2-metrics-account-tags.md): Discover authorised connections, source accounts and connector catalogues. - [Create a source account tag](https://chatobserver.com/docs/api-reference/data-connections/post-v2-metrics-account-tags.md): Discover authorised connections, source accounts and connector catalogues. - [List source catalogues](https://chatobserver.com/docs/api-reference/data-connections/get-v2-metrics-catalogues.md): Discover authorised connections, source accounts and connector catalogues. Required scopes: `metrics:read`. - [List data connections](https://chatobserver.com/docs/api-reference/data-connections/get-v2-metrics-connections.md): Discover authorised connections, source accounts and connector catalogues. Required scopes: `metrics:read`. - [List data connectors](https://chatobserver.com/docs/api-reference/data-connections/get-v2-metrics-connectors.md): Discover authorised connections, source accounts and connector catalogues. Required scopes: `metrics:read`. - [List integration clients](https://chatobserver.com/docs/api-reference/data-connections/get-v2-metrics-integration-clients.md): Discover authorised connections, source accounts and connector catalogues. - [Update a source account tag](https://chatobserver.com/docs/api-reference/data-connections/put-v2-metrics-account-tags-account-tag-id.md): Discover authorised connections, source accounts and connector catalogues. - [Update source account exclusion](https://chatobserver.com/docs/api-reference/data-connections/put-v2-metrics-source-accounts-source-account-id-exclusion.md): Discover authorised connections, source accounts and connector catalogues. - [How do I create and publish queries with the Data API?](https://chatobserver.com/docs/api-reference/data-queries.md): Create versioned queries, publish definitions and inspect integration contracts. - [List saved queries](https://chatobserver.com/docs/api-reference/data-queries/get-v2-metrics-queries.md): Create versioned queries, publish definitions and inspect integration contracts. Required scopes: `metrics:read`. - [Create a query](https://chatobserver.com/docs/api-reference/data-queries/post-v2-metrics-queries.md): Create versioned queries, publish definitions and inspect integration contracts. Required scopes: `metrics:write`. - [Read query insights](https://chatobserver.com/docs/api-reference/data-queries/get-v2-metrics-queries-query-id-insights.md): Create versioned queries, publish definitions and inspect integration contracts. - [Inspect the query integration contract](https://chatobserver.com/docs/api-reference/data-queries/get-v2-metrics-queries-query-id-integration-contract.md): Create versioned queries, publish definitions and inspect integration contracts. Required scopes: `metrics:read`. - [Execute a query for an integration](https://chatobserver.com/docs/api-reference/data-queries/post-v2-metrics-queries-query-id-integration-runs.md): Create versioned queries, publish definitions and inspect integration contracts. Required scopes: `metrics:execute`. - [Create a version of a query](https://chatobserver.com/docs/api-reference/data-queries/post-v2-metrics-queries-query-id-versions.md): Create versioned queries, publish definitions and inspect integration contracts. Required scopes: `metrics:write`. - [Publish a version of a query](https://chatobserver.com/docs/api-reference/data-queries/post-v2-metrics-queries-query-id-versions-version-id-publish.md): Create versioned queries, publish definitions and inspect integration contracts. Required scopes: `metrics:write`. - [How do I execute Data API operations and retrieve results?](https://chatobserver.com/docs/api-reference/data-operations.md): Execute, validate, cancel and inspect operations and page through result rows. - [Read saved data with MCP](https://chatobserver.com/docs/api-reference/data-operations/post-v2-metrics-mcp.md): Execute, validate, cancel and inspect operations and page through result rows. - [List operations](https://chatobserver.com/docs/api-reference/data-operations/get-v2-metrics-operations.md): Execute, validate, cancel and inspect operations and page through result rows. - [Create an operation](https://chatobserver.com/docs/api-reference/data-operations/post-v2-metrics-operations.md): Execute, validate, cancel and inspect operations and page through result rows. - [Create definitions in a batch](https://chatobserver.com/docs/api-reference/data-operations/post-v2-metrics-commands-batch-create.md): Execute, validate, cancel and inspect operations and page through result rows. - [Clone a reusable definition](https://chatobserver.com/docs/api-reference/data-operations/post-v2-metrics-commands-clone.md): Execute, validate, cancel and inspect operations and page through result rows. - [Validate a definition command](https://chatobserver.com/docs/api-reference/data-operations/post-v2-metrics-commands-validate.md): Execute, validate, cancel and inspect operations and page through result rows. - [Get an operation](https://chatobserver.com/docs/api-reference/data-operations/get-v2-metrics-operations-operation-id.md): Execute, validate, cancel and inspect operations and page through result rows. Required scopes: `metrics:read`. - [Create an operation](https://chatobserver.com/docs/api-reference/data-operations/post-v2-metrics-imports-imported-dataset-id-operations.md): Execute, validate, cancel and inspect operations and page through result rows. - [Cancel an operation](https://chatobserver.com/docs/api-reference/data-operations/post-v2-metrics-operations-operation-id-cancel.md): Execute, validate, cancel and inspect operations and page through result rows. Required scopes: `metrics:execute`. - [Read operation results](https://chatobserver.com/docs/api-reference/data-operations/get-v2-metrics-operations-operation-id-results.md): Execute, validate, cancel and inspect operations and page through result rows. Required scopes: `metrics:read`. - [How do I manage data imports, schedules and destinations through the API?](https://chatobserver.com/docs/api-reference/data-delivery.md): Manage schedules, transfers, destinations and import workflows. - [List delivery destinations](https://chatobserver.com/docs/api-reference/data-delivery/get-v2-metrics-destinations.md): Manage schedules, transfers, destinations and import workflows. - [Create a delivery destination](https://chatobserver.com/docs/api-reference/data-delivery/post-v2-metrics-destinations.md): Manage schedules, transfers, destinations and import workflows. - [Create an email import intake](https://chatobserver.com/docs/api-reference/data-delivery/post-v2-metrics-import-email-intakes.md): Manage schedules, transfers, destinations and import workflows. - [Create an import source](https://chatobserver.com/docs/api-reference/data-delivery/post-v2-metrics-import-sources.md): Manage schedules, transfers, destinations and import workflows. - [List imported datasets](https://chatobserver.com/docs/api-reference/data-delivery/get-v2-metrics-imports.md): Manage schedules, transfers, destinations and import workflows. - [Create an imported dataset](https://chatobserver.com/docs/api-reference/data-delivery/post-v2-metrics-imports.md): Manage schedules, transfers, destinations and import workflows. - [List refresh schedules](https://chatobserver.com/docs/api-reference/data-delivery/get-v2-metrics-schedules.md): Manage schedules, transfers, destinations and import workflows. - [Create a refresh schedule](https://chatobserver.com/docs/api-reference/data-delivery/post-v2-metrics-schedules.md): Manage schedules, transfers, destinations and import workflows. - [List data transfers](https://chatobserver.com/docs/api-reference/data-delivery/get-v2-metrics-transfers.md): Manage schedules, transfers, destinations and import workflows. - [Create a data transfer](https://chatobserver.com/docs/api-reference/data-delivery/post-v2-metrics-transfers.md): Manage schedules, transfers, destinations and import workflows. - [Create a version of a delivery destination](https://chatobserver.com/docs/api-reference/data-delivery/post-v2-metrics-destinations-destination-id-versions.md): Manage schedules, transfers, destinations and import workflows. - [Register an email import attachment](https://chatobserver.com/docs/api-reference/data-delivery/post-v2-metrics-import-email-intakes-intake-id-attachments.md): Manage schedules, transfers, destinations and import workflows. - [Finalise an import source](https://chatobserver.com/docs/api-reference/data-delivery/post-v2-metrics-import-sources-source-object-id-finalize.md): Manage schedules, transfers, destinations and import workflows. - [Profile an import source](https://chatobserver.com/docs/api-reference/data-delivery/post-v2-metrics-import-sources-source-object-id-profile.md): Manage schedules, transfers, destinations and import workflows. - [Create an import upload session](https://chatobserver.com/docs/api-reference/data-delivery/post-v2-metrics-import-sources-source-object-id-upload-session.md): Manage schedules, transfers, destinations and import workflows. - [Request dataset deletion](https://chatobserver.com/docs/api-reference/data-delivery/post-v2-metrics-imports-imported-dataset-id-deletion.md): Manage schedules, transfers, destinations and import workflows. - [Cancel dataset deletion](https://chatobserver.com/docs/api-reference/data-delivery/delete-v2-metrics-imports-imported-dataset-id-deletion.md): Manage schedules, transfers, destinations and import workflows. - [Update the status of a refresh schedule](https://chatobserver.com/docs/api-reference/data-delivery/put-v2-metrics-schedules-schedule-id-status.md): Manage schedules, transfers, destinations and import workflows. - [Create a version of a refresh schedule](https://chatobserver.com/docs/api-reference/data-delivery/post-v2-metrics-schedules-schedule-id-versions.md): Manage schedules, transfers, destinations and import workflows. - [Update the status of a data transfer](https://chatobserver.com/docs/api-reference/data-delivery/put-v2-metrics-transfers-transfer-id-status.md): Manage schedules, transfers, destinations and import workflows. - [Create a version of a data transfer](https://chatobserver.com/docs/api-reference/data-delivery/post-v2-metrics-transfers-transfer-id-versions.md): Manage schedules, transfers, destinations and import workflows. - [Publish a version of a delivery destination](https://chatobserver.com/docs/api-reference/data-delivery/post-v2-metrics-destinations-destination-id-versions-version-id-publish.md): Manage schedules, transfers, destinations and import workflows. - [Publish a version of a refresh schedule](https://chatobserver.com/docs/api-reference/data-delivery/post-v2-metrics-schedules-schedule-id-versions-version-id-publish.md): Manage schedules, transfers, destinations and import workflows. - [Publish a version of a data transfer](https://chatobserver.com/docs/api-reference/data-delivery/post-v2-metrics-transfers-transfer-id-versions-version-id-publish.md): Manage schedules, transfers, destinations and import workflows. - [How do I create and version reusable data definitions through the API?](https://chatobserver.com/docs/api-reference/data-definitions.md): Manage reusable definitions and their immutable versions. - [List analysis views](https://chatobserver.com/docs/api-reference/data-definitions/get-v2-metrics-analysis-views.md): Manage reusable definitions and their immutable versions. - [Create an analysis view](https://chatobserver.com/docs/api-reference/data-definitions/post-v2-metrics-analysis-views.md): Manage reusable definitions and their immutable versions. - [List query templates](https://chatobserver.com/docs/api-reference/data-definitions/get-v2-metrics-templates.md): Manage reusable definitions and their immutable versions. - [Get usage](https://chatobserver.com/docs/api-reference/data-definitions/get-v2-metrics-usage.md): Manage reusable definitions and their immutable versions. - [List reusable definitions](https://chatobserver.com/docs/api-reference/data-definitions/get-v2-metrics-definitions-resource-type.md): Manage reusable definitions and their immutable versions. - [Create a reusable definition](https://chatobserver.com/docs/api-reference/data-definitions/post-v2-metrics-definitions-resource-type.md): Manage reusable definitions and their immutable versions. - [Create a version of a reusable definition](https://chatobserver.com/docs/api-reference/data-definitions/post-v2-metrics-definitions-resource-type-resource-id-versions.md): Manage reusable definitions and their immutable versions. - [Publish a version of a reusable definition](https://chatobserver.com/docs/api-reference/data-definitions/post-v2-metrics-definitions-resource-type-resource-id-versions-version-id-publish.md): Manage reusable definitions and their immutable versions. - [How do I manage signed Data API webhooks?](https://chatobserver.com/docs/api-reference/data-webhooks.md): Configure event delivery, inspect deliveries, replay events and rotate secrets. - [List webhook endpoints](https://chatobserver.com/docs/api-reference/data-webhooks/get-v2-metrics-webhooks.md): Configure event delivery, inspect deliveries, replay events and rotate secrets. - [Create a webhook endpoint](https://chatobserver.com/docs/api-reference/data-webhooks/post-v2-metrics-webhooks.md): Configure event delivery, inspect deliveries, replay events and rotate secrets. - [Update a webhook endpoint](https://chatobserver.com/docs/api-reference/data-webhooks/patch-v2-metrics-webhooks-endpoint-id.md): Configure event delivery, inspect deliveries, replay events and rotate secrets. - [Delete a webhook endpoint](https://chatobserver.com/docs/api-reference/data-webhooks/delete-v2-metrics-webhooks-endpoint-id.md): Configure event delivery, inspect deliveries, replay events and rotate secrets. - [List webhook deliveries](https://chatobserver.com/docs/api-reference/data-webhooks/get-v2-metrics-webhooks-endpoint-id-deliveries.md): Configure event delivery, inspect deliveries, replay events and rotate secrets. - [Rotate the webhook signing secret](https://chatobserver.com/docs/api-reference/data-webhooks/post-v2-metrics-webhooks-endpoint-id-rotate.md): Configure event delivery, inspect deliveries, replay events and rotate secrets. - [Replay a webhook delivery](https://chatobserver.com/docs/api-reference/data-webhooks/post-v2-metrics-webhooks-endpoint-id-deliveries-delivery-id-replay.md): Configure event delivery, inspect deliveries, replay events and rotate secrets. - [How do spreadsheet clients request user authorisation?](https://chatobserver.com/docs/api-reference/client-authorisation.md): Authorise spreadsheet clients using a user-approved challenge exchange. - [Create an authorisation challenge](https://chatobserver.com/docs/api-reference/client-authorisation/post-v2-metrics-client-auth-challenges.md): Authorise spreadsheet clients using a user-approved challenge exchange. - [Exchange an approved authorisation challenge](https://chatobserver.com/docs/api-reference/client-authorisation/post-v2-metrics-client-auth-challenges-challenge-id-exchange.md): Authorise spreadsheet clients using a user-approved challenge exchange. - [Renew a spreadsheet connection](https://chatobserver.com/docs/api-reference/client-authorisation/post-v2-metrics-client-auth-sessions-session-id-renew.md): Use only near access-session expiry, on actual add-on use. Persist the complete command before sending; a lost reply must retry the identical request and next credentials. Successful renewal rotates both credentials and extends the connection inactivity window to 180 days. Reusing a consumed credent… - [Revoke a spreadsheet connection](https://chatobserver.com/docs/api-reference/client-authorisation/post-v2-metrics-client-auth-sessions-session-id-revoke.md): Revoke a document-bound renewable connection even after the access session expires or renewal rollout is disabled. Retrying revocation is safe; retain the private revocation intent after a lost response. This also revokes document formula grants belonging to the actor. - [How do I read and write data with an authorised spreadsheet client?](https://chatobserver.com/docs/api-reference/spreadsheet-clients.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [List spreadsheet bindings](https://chatobserver.com/docs/api-reference/spreadsheet-clients/get-v2-metrics-client-bindings.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Create a spreadsheet binding](https://chatobserver.com/docs/api-reference/spreadsheet-clients/post-v2-metrics-client-bindings.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [List source catalogues](https://chatobserver.com/docs/api-reference/spreadsheet-clients/get-v2-metrics-client-catalogues.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [List data connections](https://chatobserver.com/docs/api-reference/spreadsheet-clients/get-v2-metrics-client-connections.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [List data connectors](https://chatobserver.com/docs/api-reference/spreadsheet-clients/get-v2-metrics-client-connectors.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [List workspace members](https://chatobserver.com/docs/api-reference/spreadsheet-clients/get-v2-metrics-client-members.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [List operations](https://chatobserver.com/docs/api-reference/spreadsheet-clients/get-v2-metrics-client-operations.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Create an operation](https://chatobserver.com/docs/api-reference/spreadsheet-clients/post-v2-metrics-client-operations.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [List saved queries](https://chatobserver.com/docs/api-reference/spreadsheet-clients/get-v2-metrics-client-queries.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Create a query](https://chatobserver.com/docs/api-reference/spreadsheet-clients/post-v2-metrics-client-queries.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [List refresh schedules](https://chatobserver.com/docs/api-reference/spreadsheet-clients/get-v2-metrics-client-schedules.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Create a refresh schedule](https://chatobserver.com/docs/api-reference/spreadsheet-clients/post-v2-metrics-client-schedules.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Inspect the spreadsheet session](https://chatobserver.com/docs/api-reference/spreadsheet-clients/get-v2-metrics-client-session.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Revoke the spreadsheet session](https://chatobserver.com/docs/api-reference/spreadsheet-clients/delete-v2-metrics-client-session.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [List query templates](https://chatobserver.com/docs/api-reference/spreadsheet-clients/get-v2-metrics-client-templates.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Create a spreadsheet write claim](https://chatobserver.com/docs/api-reference/spreadsheet-clients/post-v2-metrics-client-writes.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Delete a spreadsheet binding](https://chatobserver.com/docs/api-reference/spreadsheet-clients/delete-v2-metrics-client-bindings-binding-id.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Get an operation](https://chatobserver.com/docs/api-reference/spreadsheet-clients/get-v2-metrics-client-operations-operation-id.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Delete a spreadsheet write claim](https://chatobserver.com/docs/api-reference/spreadsheet-clients/delete-v2-metrics-client-writes-write-claim-id.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Transfer spreadsheet resource ownership](https://chatobserver.com/docs/api-reference/spreadsheet-clients/post-v2-metrics-client-bindings-binding-id-ownership.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Create a version of a spreadsheet binding](https://chatobserver.com/docs/api-reference/spreadsheet-clients/post-v2-metrics-client-bindings-binding-id-versions.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Cancel an operation](https://chatobserver.com/docs/api-reference/spreadsheet-clients/post-v2-metrics-client-operations-operation-id-cancel.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Read operation results](https://chatobserver.com/docs/api-reference/spreadsheet-clients/get-v2-metrics-client-operations-operation-id-results.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Read query insights](https://chatobserver.com/docs/api-reference/spreadsheet-clients/get-v2-metrics-client-queries-query-id-insights.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Create a version of a query](https://chatobserver.com/docs/api-reference/spreadsheet-clients/post-v2-metrics-client-queries-query-id-versions.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Transfer spreadsheet resource ownership](https://chatobserver.com/docs/api-reference/spreadsheet-clients/post-v2-metrics-client-schedules-schedule-id-ownership.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Update the status of a refresh schedule](https://chatobserver.com/docs/api-reference/spreadsheet-clients/put-v2-metrics-client-schedules-schedule-id-status.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Create a version of a refresh schedule](https://chatobserver.com/docs/api-reference/spreadsheet-clients/post-v2-metrics-client-schedules-schedule-id-versions.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Record a spreadsheet write checkpoint](https://chatobserver.com/docs/api-reference/spreadsheet-clients/post-v2-metrics-client-writes-write-claim-id-checkpoints.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Commit a spreadsheet write](https://chatobserver.com/docs/api-reference/spreadsheet-clients/post-v2-metrics-client-writes-write-claim-id-commit.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Publish a version of a spreadsheet binding](https://chatobserver.com/docs/api-reference/spreadsheet-clients/post-v2-metrics-client-bindings-binding-id-versions-version-id-publish.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Publish a version of a query](https://chatobserver.com/docs/api-reference/spreadsheet-clients/post-v2-metrics-client-queries-query-id-versions-version-id-publish.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [Publish a version of a refresh schedule](https://chatobserver.com/docs/api-reference/spreadsheet-clients/post-v2-metrics-client-schedules-schedule-id-versions-version-id-publish.md): Access document-bound client sessions, queries, schedules, bindings and write claims. - [How do I create website AI visibility audits through the API?](https://chatobserver.com/docs/api-reference/ai-visibility-audits.md): Create website visibility audits and retrieve their report links. - [Create an AI visibility audit](https://chatobserver.com/docs/api-reference/ai-visibility-audits/post-v1-audits.md): Create a website visibility audit and retrieve its report link. Workspace API keys require write access; publishable embed keys require an allowed Origin. - [Get an AI visibility audit](https://chatobserver.com/docs/api-reference/ai-visibility-audits/get-v1-audits-id.md): Retrieve the status and report link of an audit owned by this workspace. Workspace API keys require read access; publishable embed keys require an allowed Origin. - [Which version 1 AI visibility API endpoints are available?](https://chatobserver.com/docs/api-reference/version-1.md): Integrate with the version 1 visibility and analytics endpoints. - [Get brand visibility](https://chatobserver.com/docs/api-reference/version-1/get-v1-brand-visibility.md): Integrate with the version 1 visibility and analytics endpoints. - [List collected answers](https://chatobserver.com/docs/api-reference/version-1/get-v1-prompt-runs.md): Integrate with the version 1 visibility and analytics endpoints. - [List monitoring prompts](https://chatobserver.com/docs/api-reference/version-1/get-v1-prompts.md): Integrate with the version 1 visibility and analytics endpoints. - [Get visitor metrics](https://chatobserver.com/docs/api-reference/version-1/get-v1-analytics-visitor-metrics.md): Integrate with the version 1 visibility and analytics endpoints. - [Get AI crawler events](https://chatobserver.com/docs/api-reference/version-1/get-v1-crawler-logs-events.md): Integrate with the version 1 visibility and analytics endpoints. - [Get crawler log integrations](https://chatobserver.com/docs/api-reference/version-1/get-v1-crawler-logs-integrations.md): Integrate with the version 1 visibility and analytics endpoints. - [Get workspace metrics](https://chatobserver.com/docs/api-reference/version-1/get-v1-metrics-summary.md): Integrate with the version 1 visibility and analytics endpoints. - [Get a collected answer](https://chatobserver.com/docs/api-reference/version-1/get-v1-prompt-runs-id.md): Integrate with the version 1 visibility and analytics endpoints. - [Get source domains](https://chatobserver.com/docs/api-reference/version-1/get-v1-sources-domains.md): Integrate with the version 1 visibility and analytics endpoints. - [Get source overview](https://chatobserver.com/docs/api-reference/version-1/get-v1-sources-overview.md): Integrate with the version 1 visibility and analytics endpoints. - [Get monthly answer usage](https://chatobserver.com/docs/api-reference/version-1/get-v1-usage-monthly.md): Integrate with the version 1 visibility and analytics endpoints. - [How do I manage published coverage and citation evidence through the API?](https://chatobserver.com/docs/api-reference/tracked-coverage.md): Track published coverage, maintain its metadata and inspect exact-page citation evidence with the same workspace feature access as the dashboard. - [List tracked coverage](https://chatobserver.com/docs/api-reference/tracked-coverage/get-v2-coverage.md): Coverage requires Sources access and the coverage feature to be enabled for the workspace. API keys remain workspace-bound. Delegated MCP connections require coverage:read. Includes uncited records. Active and archived collections are queried separately. Page pagination reflects current data and is… - [Add tracked coverage](https://chatobserver.com/docs/api-reference/tracked-coverage/post-v2-coverage.md): Coverage requires Sources access and the coverage feature to be enabled for the workspace. API keys remain workspace-bound. Delegated MCP connections require coverage:write and a stable idempotency key. Only url is required. Optional metadata defaults to empty values, article and unclassified. Dupli… - [Get tracked coverage and evidence](https://chatobserver.com/docs/api-reference/tracked-coverage/get-v2-coverage-detail.md): Coverage requires Sources access and the coverage feature to be enabled for the workspace. API keys remain workspace-bound. Delegated MCP connections require coverage:read. Returns the record, a page of matching cited answers and the 20 latest history entries. Evidence is citation-only across retain… - [Update, archive or restore tracked coverage](https://chatobserver.com/docs/api-reference/tracked-coverage/patch-v2-coverage.md): Coverage requires Sources access and the coverage feature to be enabled for the workspace. API keys remain workspace-bound. Delegated MCP connections require coverage:write and a stable idempotency key. Supply the current version and an explicit action. Update replaces all metadata fields. A stale v… - [Measure tracked coverage citation evidence](https://chatobserver.com/docs/api-reference/tracked-coverage/get-v2-coverage-measurement.md): Measure the same coverage-observations-v2 populations as the dashboard. Supply an inclusive UTC calendar range of at most 366 days; comparison uses the preceding equal-length range. Cohort shared restricts observations to prompt/platform/region cells present in both periods. Citation and brand asses… - [Find existing coverage by published URL](https://chatobserver.com/docs/api-reference/tracked-coverage/post-v2-coverage-lookup.md): Read-only lookup of up to 50 page URLs, including archived records. Matching ignores protocol, www host prefix and fragment, and preserves path case, query parameters and trailing slash. Results contain only existing matches in the credential workspace. No URL is fetched and no record is created. Re… - [How do I compose and assess native reports through the API?](https://chatobserver.com/docs/api-reference/reports.md): Discover accessible native reports and assess exact saved revisions using measured, context-specific evidence. - [Create a private native empty report draft](https://chatobserver.com/docs/api-reference/reports/create-native-report-draft.md): Requires delegated reports:write consent, native workspace create permission and current authoring availability. Workspace service keys are unsupported. A stable client report UUID and Idempotency-Key bind the original command before resolving defaults. An identical retry returns the initial native… - [Find accessible reports](https://chatobserver.com/docs/api-reference/reports/get-canvas-reports.md): Requires user-authorized Chatobserver MCP consent, reports:read, current native membership and report access, and workspace feature availability. Workspace service keys are unsupported. Cached report outputs additionally require independent Data access and data:read consent. Report discovery and ass… - [Read the exact report identity and assessment pages](https://chatobserver.com/docs/api-reference/reports/get-canvas-report.md): Requires user-authorized Chatobserver MCP consent, reports:read, current native membership and report access, and workspace feature availability. Workspace service keys are unsupported. Cached report outputs additionally require independent Data access and data:read consent. Report discovery and ass… - [Discover native assessment targets, contexts and profiles](https://chatobserver.com/docs/api-reference/reports/get-canvas-capabilities.md): Requires user-authorized Chatobserver MCP consent, reports:read, current native membership and report access, and workspace feature availability. Workspace service keys are unsupported. Cached report outputs additionally require independent Data access and data:read consent. Report discovery and ass… - [Assess an exact saved report revision](https://chatobserver.com/docs/api-reference/reports/post-canvas-assessment.md): Requires user-authorized Chatobserver MCP consent, reports:read, current native membership and report access, and workspace feature availability. Workspace service keys are unsupported. Cached report outputs additionally require independent Data access and data:read consent. Report discovery and ass… - [Read assessment or composition progress](https://chatobserver.com/docs/api-reference/reports/get-canvas-job.md): The entry point accepts reports:read or reports:write. The owning job requires its exact current family consent: reports:read for assessment, reports:write for composition, plus current workspace and report permission. Derived progress is not a rendered-quality verdict. Workspace service keys are un… - [Cancel assessment or composition work](https://chatobserver.com/docs/api-reference/reports/cancel-canvas-job.md): Cancel derived work under its exact current family consent: reports:read for assessment or reports:write for composition. The original owner, current workspace/report permission and feature availability are rechecked. Preserve a UUID Idempotency-Key across uncertain retries; cancellation is function… - [Read assessment readiness and pageable findings](https://chatobserver.com/docs/api-reference/reports/get-canvas-assessment.md): Requires user-authorized Chatobserver MCP consent, reports:read, current native membership and report access, and workspace feature availability. Workspace service keys are unsupported. Cached report outputs additionally require independent Data access and data:read consent. Report discovery and ass… - [Discover granular native configuration contracts](https://chatobserver.com/docs/api-reference/reports/get-report-capability-index.md): Requires user-authorized Chatobserver MCP consent, reports:read, current native membership and report access, and workspace feature availability. Workspace service keys are unsupported. Cached report outputs additionally require independent Data access and data:read consent. Report discovery and ass… - [Read one versioned native configuration schema](https://chatobserver.com/docs/api-reference/reports/get-report-capability-schema.md): Requires user-authorized Chatobserver MCP consent, reports:read, current native membership and report access, and workspace feature availability. Workspace service keys are unsupported. Cached report outputs additionally require independent Data access and data:read consent. Report discovery and ass… - [Begin exact private native authoring](https://chatobserver.com/docs/api-reference/reports/create-report-change-set.md): Requires delegated reports:write consent, current native report edit permission and workspace authoring availability. Workspace service keys are unsupported. These private stages never alter the saved report, run Data, publish a share or certify rendered layout. Requests stream at most 512 KiB. Stag… - [Read confirmed private authoring receipts](https://chatobserver.com/docs/api-reference/reports/read-report-change-set.md): Requires delegated reports:write consent, current native report edit permission and workspace authoring availability. Workspace service keys are unsupported. These private stages never alter the saved report, run Data, publish a share or certify rendered layout. Requests stream at most 512 KiB. Stag… - [Discard uncommitted private authoring](https://chatobserver.com/docs/api-reference/reports/discard-report-change-set.md): Requires delegated reports:write consent, current native report edit permission and workspace authoring availability. Workspace service keys are unsupported. These private stages never alter the saved report, run Data, publish a share or certify rendered layout. Requests stream at most 512 KiB. Stag… - [Append typed native changes](https://chatobserver.com/docs/api-reference/reports/append-report-changes.md): Requires delegated reports:write consent, current native report edit permission and workspace authoring availability. Workspace service keys are unsupported. These private stages never alter the saved report, run Data, publish a share or certify rendered layout. Requests stream at most 512 KiB. Stag… - [Validate and freeze the native stage](https://chatobserver.com/docs/api-reference/reports/seal-report-change-set.md): Requires delegated reports:write consent, current native report edit permission and workspace authoring availability. Workspace service keys are unsupported. These private stages never alter the saved report, run Data, publish a share or certify rendered layout. Requests stream at most 512 KiB. Stag… - [Compose a sealed native change set](https://chatobserver.com/docs/api-reference/reports/post-canvas-composition.md): Requires delegated reports:write consent, current native edit permission and workspace authoring availability. Data is independently authorized: composition consumes readable pinned outputs and never executes providers. A sealed stage is composed and measured in its declared fixed or responsive mode… - [Read measured plan and bounded placements/findings](https://chatobserver.com/docs/api-reference/reports/get-canvas-plan.md): Requires delegated reports:write consent, current native edit permission and workspace authoring availability. Data is independently authorized: composition consumes readable pinned outputs and never executes providers. A sealed stage is composed and measured in its declared fixed or responsive mode… - [Install the exact measured native candidate atomically](https://chatobserver.com/docs/api-reference/reports/commit-canvas-plan.md): Requires delegated reports:write consent, current native edit permission and workspace authoring availability. Data is independently authorized: composition consumes readable pinned outputs and never executes providers. A sealed stage is composed and measured in its declared fixed or responsive mode… - [Read workspace branding, fonts and authoring guide](https://chatobserver.com/docs/api-reference/reports/get-report-authoring-context.md): Requires user-authorized Chatobserver MCP consent, reports:read, current native membership and report access, and workspace feature availability. Workspace service keys are unsupported. Cached report outputs additionally require independent Data access and data:read consent. Report discovery and ass… - [Compare private document and existing shared artifact identities](https://chatobserver.com/docs/api-reference/reports/get-report-publication-state.md): Requires user-authorized Chatobserver MCP consent, reports:read, current native membership and report access, and workspace feature availability. Workspace service keys are unsupported. Cached report outputs additionally require independent Data access and data:read consent. Report discovery and ass… - [Read complete native page elements and optional surface provenance](https://chatobserver.com/docs/api-reference/reports/get-native-report-page.md): Requires user-authorized Chatobserver MCP consent, reports:read, current native membership and report access, and workspace feature availability. Workspace service keys are unsupported. Cached report outputs additionally require independent Data access and data:read consent. Report discovery and ass… - [Read independently authorized source contracts without executing Data](https://chatobserver.com/docs/api-reference/reports/get-native-report-data-sources.md): Requires user-authorized Chatobserver MCP consent, reports:read, current native membership and report access, and workspace feature availability. Workspace service keys are unsupported. Cached report outputs additionally require independent Data access and data:read consent. Report discovery and ass… - [Attach a Data query to a report](https://chatobserver.com/docs/api-reference/reports/attach-report-query.md): Create a native report-owned reference to a readable published Metrics V2 query/version. Delegated OAuth only; reports:write, data:read, native report edit and current query/connection/network access are required. Returns immutable attachment and semantic catalogue identities. UUID retries preserve… - [Upload a report image](https://chatobserver.com/docs/api-reference/reports/upload-report-image.md): Upload a public HTTPS image or canonical base64 PNG, JPEG or WebP (maximum 1MB) to the selected workspace. Requires reports:write, current author permission and report-authoring availability. The UUID Idempotency-Key identifies one immutable upload. Preserve the identical request on retries: complet… - [Create a native report share](https://chatobserver.com/docs/api-reference/reports/create-report-share.md): Publish the exact saved report identity through the native shared report pipeline. Delegated user OAuth only; requires reports:publish, native publish permission and independent Data access. UUID retries preserve one atomic publication and do not publish later edits. An unlisted link is available to… - [Revoke a native report share](https://chatobserver.com/docs/api-reference/reports/revoke-report-share.md): Revoke this exact report share using current delegated reports:publish consent and native manage permission. Repeated revocation is safe. Preserves the private report, datasets and uploaded assets. Requires a delegated MCP user connection; workspace API keys cannot impersonate a publishing user. - [Adopt cached query output for a report](https://chatobserver.com/docs/api-reference/reports/adopt-report-query-output.md): Materialize only the retained successful output of an exact pinned Metrics V2 query version. Requires reports:write, data:read and current report/query/connection/network permissions. UUID retries reconcile the original cached generation. Missing or expired output remains explicit. No provider execu… - [Save native report edits using a revision](https://chatobserver.com/docs/api-reference/reports/save-native-report.md): Atomically save typed native operations in freeform or responsive mode. Semantic regions compile into editable native placements; preserve retains complete authored geometry. Requires reports:write and current native edit permission. Data attachments remain report-owned and require independent Data… - [List built-in report datasets](https://chatobserver.com/docs/api-reference/reports/list-native-report-datasets.md): Discover active native Chatobserver datasets, including AI visibility and the existing branded/unbranded comparison, with field identities and supported views. Requires independent Data read consent. No external connector or provider run. - [Attach and snapshot native report evidence](https://chatobserver.com/docs/api-reference/reports/attach-native-report-dataset.md): Attach a built-in dataset from the native catalogue to this report and materialize an immutable generation using its saved date range. Returns report-owned attachment and semantic field identities for native charts, KPIs and tables. Requires current report edit and independent Data access. External… - [How do I use authorized SEO tools with MCP?](https://chatobserver.com/docs/api-reference/seo.md): Use authorized workspace SEO tools through the stateless MCP endpoint. Availability follows native workspace access and rollout controls; paid tools require a separately configured SEO allowance and spending admission. OpenSEO AI visibility tools remain unavailable. - [Call authorized SEO tools with MCP](https://chatobserver.com/docs/api-reference/seo/post-seo-mcp.md): Stateless MCP JSON-RPC over HTTP POST. Use a workspace service-account API key or a delegated MCP application credential. Legacy keys with the read scope retain read-only access; SEO mutation and execution tools additionally require seo:write and seo:run respectively. A delegated credential selectin… - [Reject unsupported SEO MCP GET](https://chatobserver.com/docs/api-reference/seo/get-seo-mcp-unsupported.md): The SEO MCP transport is stateless and accepts POST only. This method returns 405 without executing a tool or opening a session. - [Reject unsupported SEO MCP DELETE](https://chatobserver.com/docs/api-reference/seo/delete-seo-mcp-unsupported.md): The SEO MCP transport is stateless and accepts POST only. This method returns 405 without executing a tool or opening a session. ## OpenAPI Specs - [openapi](/docs/openapi.json) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.