事件 · 合集与文件夹

folder.deleted

文件夹已删除

文件夹已被删除。其子文件夹和卡片移至父文件夹（每张卡片各有一个 card.moved 事件）。

对象类型: folder
投递对象: 能看到该对象的 Webhook：按角色、数据权限档案和合集确定

有效负载

idstring必填
事件 ID（evt_…），也会作为 webhook-id 头发送。可用于丢弃重复的投递。
typestring必填
可选值: folder.deleted
created_atstring (date-time)必填
变更发生的时间（UTC）。
org_idinteger必填
api_versionstring必填
data 结构定义的契约版本。
sequenceinteger
在该 Webhook 内的投递序号（测试事件不返回）。
objectWebhookEventObject必填
payloadstring必填
thin 表示没有 data：请通过 API 读取对象。
可选值: fullthin
dataobject
字段
- folderEventFolder必填
- actor_idinteger | null必填
  执行该操作的用户；由组织 API 密钥或平台自身执行时为 null。
- promoted_foldersinteger必填
- promoted_cardsinteger必填
testboolean必填
由 POST /v1/webhooks/{webhook_id}/test 发送的测试事件。

投递示例

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "folder.deleted",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "folder",
    "id": "41"
  },
  "payload": "full",
  "data": {
    "folder": {
      "id": "41",
      "title": "Billing",
      "collection": "support",
      "collection_id": 3,
      "parent_id": null,
      "color": null,
      "icon": null,
      "metadata": {}
    },
    "actor_id": 7,
    "promoted_folders": 1,
    "promoted_cards": 4
  },
  "test": false
}

接收事件

每次投递都是向 Webhook 接收地址发送的 POST 请求，请求体就是这个 JSON。先验证 webhook-signature 头（Standard Webhooks），再信任请求体；在几秒内返回 2xx 状态，之后再处理。投递到同一个 Webhook 的事件保持原有顺序；投递失败时按逐渐拉长的间隔重试。

随时可能新增事件类型和字段：跳过不认识的类型和字段。

同样的事件在事件记录中保留 30 天 →