project.deleted

This is the final event you will receive for the given project_id. Stop emitting requests against this project after delivery.

When this fires

A project is hard-deleted by the creator. The project row and dependent data are removed; this is the final event you will receive for that project_id.

Required ability

project:view — token must carry this at mint time to subscribe an endpoint to this event.

Payload

{
  "id": "evt_01HX...",
  "type": "project.deleted",
  "created_at": "2026-05-18T10:05:00Z",
  "api_version": "2026-05-01",
  "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
  "data": {
    "project": {
      "id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
      "name": "Research Premium",
      "handle": "research-premium",
      "active": true,
      "team_id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86"
    }
  }
}

Field reference

Field	Type	Notes
`id`	string ULID	Unique event id, prefixed `evt_`. Use for idempotent processing.
`type`	string	Always `project.deleted` for this event.
`created_at`	ISO 8601 timestamp	Server-side emission time.
`api_version`	string	Webhook API contract version.
`project_id`	string UUID	Project this event belongs to.
`data.project.id`	string UUID	Project identifier; matches the top-level `project_id`.
`data.project.name`	string	Display name.
`data.project.handle`	string	URL slug for the public landing page.
`data.project.active`	boolean	Last-known active flag before deletion.
`data.project.team_id`	string UUID	Team that owns the project (a personal team for solo creators).

Caveats

After this event, the project's API endpoints will respond 404. Treat the row as gone.
Dependent rows (plans, subscriptions, resources) cascade but do not fan out their own *.deleted events — handle the project-level cleanup once.
Webhook subscriptions targeting only this project should be torn down on your side; the platform stops emitting events for it.

project.archived — typical predecessor.
project.created — first event in the lifecycle.
Project events overview — back to family overview.