import.document_failed

有效负载

对象：EventImportDocumentFailed

• idstring必填

  事件 ID（evt_…），也会作为 webhook-id 头发送。可用于丢弃重复的投递。

• typestring必填

  可选值: import.document_failed

• created_atstring (date-time)必填

  变更发生的时间（UTC）。

• org_idinteger必填
• api_versionstring必填

  data 结构定义的契约版本。

• sequenceinteger

  在该 Webhook 内的投递序号（测试事件不返回）。

• objectWebhookEventObject必填
• payloadstring必填

  thin 表示没有 data：请通过 API 读取对象。

  可选值: fullthin

• dataobject
  字段

  • sourceEventSource必填
  • documentobject必填

    自定义数据源的文档；推送 API 的文档结果报告的是相同的处理结果。

    字段

    • external_idstring | null必填
    • titlestring | null
    • card_idstring | null必填
  • run_idinteger
  • job_idinteger | null

    索引作业或导出作业。

  • reasonstring必填

    中性原因代码（可扩展枚举：将未知代码视为一般性失败）。取值为文档结果代码：content_invalid、file_rejected、too_large、limit_reached、index_failed。

• testboolean必填

  由 POST /v1/webhooks/{webhook_id}/test 发送的测试事件。

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "import.document_failed",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "source",
    "id": "5"
  },
  "payload": "full",
  "data": {
    "source": {
      "id": 5,
      "name": "Help center",
      "kind": "custom",
      "collection_id": 3
    },
    "document": {
      "external_id": "kb-article-118",
      "title": "Shipping rates",
      "card_id": null
    },
    "run_id": 902,
    "reason": "content_invalid"
  },
  "test": false
}