Workspaces & multiple sites

Workspace and site boundaries#

A workspace groups members and sites. Each site has a project UUID, domain, tracking mode, settings and integrations. Switching sites changes the active report context; renaming a workspace affects its members' workspace label rather than merging analytics.

Add a site#

Use the site switcher → add a website and complete onboarding. Configure its privacy notice and collection separately, then install its own snippet. Never reuse another site's project ID merely because both sites belong to the same company.

Agent access to new sites#

Existing keys remain site-scoped. Existing OAuth grants keep their previously approved site snapshot. A site created through create_project is not automatically readable by the credential that created it; explicitly connect or authorize it afterward.

Delete a site#

Only an owner can delete the authorized site, with exact domain confirmation. Deletion removes the site and queues analytics cleanup. This is different from deleting a funnel, key or share link. Review exports and dependencies before intentionally deleting a site.

API equivalents#

get_workspace, update_workspace, create_project, delete_project.