Skip to main content

​
DELETE /api/v1/sites/:site_id

Permanently deletes a site and all associated data including stats, goals, and configuration. This action cannot be undone.
This is a destructive operation that permanently deletes all site data. This action cannot be reversed.

​
Authentication

Requires a valid API key with the sites:provision:* scope. You must be an owner of the site to delete it.

​
Path Parameters

​
site_id
string
required
The domain of the site to delete. Can be the current domain or the previous domain if it was changed.Examples: example.com, blog.example.com

​
Response

​
deleted
boolean
Returns true if the site was successfully deleted.
curl -X DELETE https://plausible.io/api/v1/sites/example.com \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Notes

  • Only site owners can delete a site - editors, admins, and viewers cannot perform this action
  • All site data will be permanently deleted, including:
    • All pageview and event statistics
    • Goals and funnels
    • Custom properties configuration
    • Shared links
    • Email report subscriptions
    • Guest memberships and invitations
  • This operation cannot be undone - make sure to export any data you need before deleting
  • Team-scoped API keys can only delete sites belonging to that specific team

Build docs developers (and LLMs) love

Get started for freeTalk to us