project.archived

When this fires

A project is archived through POST /v1/projects/{project}/archive or the MCP archive_project tool — archiving from the dashboard does not emit this event. The only state change is the project's active flag flipping to false; existing subscriptions and the public landing page are untouched.

Required ability

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

Payload

{
  "id": "evt_01HX...",
  "type": "project.archived",
  "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": false,
      "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.archived` 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	Always `false` for this event.
`data.project.team_id`	string UUID	Team that owns the project (a personal team for solo creators).

Caveats

Archive is reversible — pair with project.restored for the inverse transition.
Subscribers retain their existing access until their ends_at ticks over — expect subscription.expired events to follow as those subscriptions wind down.
Hard-delete fires project.deleted instead and is final.

project.restored — paired transition.
project.deleted — terminal state, replaces archive when the row is hard-deleted.
Project events overview — back to family overview.