Monitor a Starport site through read-only connections

Promptless can monitor a Starport site through read-only connections you set up on the integrations page. Each connection lets Promptless read status or analytics. Promptless polls them and never writes to them. Connecting Vercel or Cloudflare Pages lets Promptless read whether your docs site built and published. Connecting PostHog lets Promptless read page views and search queries to find the pages that need work. For the full capability list, see What’s included in Starport.

Connect Vercel

Vercel connects through OAuth. On the integrations page, select Connect Vercel and complete the authorization. Promptless then reads your deployment status, so it can tell whether your docs site built and published. It never deploys, and it never changes your projects, domains, or environment variables.

Connect Cloudflare Pages

Cloudflare Pages connects with an API token. In Cloudflare, under My Profile → API Tokens, create a token with read access to Cloudflare Pages and Account Settings. On the integrations page, select Connect Cloudflare to open the Connect Cloudflare Pages modal, then paste the token into API Token. Promptless then reads your Pages project and deployment status, so it can tell whether your docs site built. It never triggers a build, and it never changes anything in your account.

Connect PostHog

PostHog connects with a Personal API key. In PostHog, create a key with read access to Query and Project. On the integrations page, select Connect PostHog. Then enter the key in Personal API key, your project’s ID in Project ID, and your region in Region (US Cloud, EU Cloud, or Self-hosted). Promptless then queries page views on your docs and search queries, so it can tell which pages need work. It never sends events, and it never changes anything in PostHog.

This read-only connection is separate from the analytics your Starport site reports on its own. For how that reporting works, see Starport analytics.

Manage a connection

Because each connection is read-only, you can remove it at any time on the integrations page. Removing it stops Promptless from reading any further. To confirm whether a connection is active, see Connection health.