project.* events
Project lifecycle, bot connection, resource link / unlink.
Fires whenever a project is created, updated, archived, restored, or deleted, plus transitions on its Telegram bot + resources.
Events
project.created
A creator registers a new project.
project.updated
Any mutable project field changes.
project.archived
Creator archives the project.
project.restored
Archived project re-activated.
project.deleted
Project hard-deleted. Final event from that project.
project.bot.connected
Telegram bot first attached.
project.bot.disconnected
Bot removed or rotated.
project.bot.status_changed
Bot enters or exits degraded state (deferred).
project.resource.created
New resource registered under the project.
project.resource.linked
Existing Telegram chat linked to the project.
project.resource.unlinked
Resource disconnected from the project.
project.resource.deleted
Resource hard-deleted.
| Event | Fires when |
|---|---|
project.created | A creator registers a new project. |
project.updated | Any mutable project field changes (name, description, handle, terms, privacy). |
project.archived | The creator archives the project; access is suspended. |
project.restored | An archived project is re-activated. |
project.deleted | A project is hard-deleted. Fires once, then nothing else from that project. |
project.bot.connected | A Telegram bot token is first attached to the project. |
project.bot.disconnected | The bot token is removed or rotated. |
project.bot.status_changed | Bot enters or exits degraded state (Telegram API failures, rate-limit, token revoke). |
project.resource.created | A new resource (channel, group, supergroup) is registered under the project. |
project.resource.linked | An existing Telegram chat is linked as a resource. |
project.resource.unlinked | A resource is disconnected from the project. |
project.resource.deleted | A resource row is hard-deleted. |
See the dedicated pages above for full payload, field reference, and caveats per event.
Example payload
{
"id": "evt_01HX...",
"type": "project.created",
"created_at": "2026-05-18T10:05:00Z",
"api_version": "2026-05-01",
"project_id": "prj_01HX...",
"data": {
"project": {
"id": "prj_01HX...",
"name": "Research Premium",
"handle": "research-premium",
"description": "Deep-dive research notes and weekly AMAs.",
"active": true,
"team_id": "tem_01HX..."
}
}
}Required abilities
Tokens subscribing to any project.* event must carry project:view-any at mint time.
How is this guide?