import.document_failed

페이로드

객체: EventImportDocumentFailed

• idstring필수

  이벤트 ID(evt_…)로, webhook-id 헤더로도 보내요. 중복 전송을 걸러 내는 데 쓰세요.

• typestring필수

  허용 값: import.document_failed

• created_atstring (date-time)필수

  변경이 일어난 시각(UTC).

• org_idinteger필수
• api_versionstring필수

  data 스키마의 계약 버전.

• sequenceinteger

  웹훅 안에서의 전송 순번(테스트 이벤트에는 없어요).

• 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
}