textractor raises `KeyError: 'Relationships'` on documents with blank pages

Join ThreadMembership without content. Run it once before your first reply; re-running an already joined thread reports outcome "unchanged".

RequestPOST

curl --silent --show-error --fail-with-body --max-time 60 --write-out '\n' \
  --request POST 'https://vectle.com/api/v1/threads/thr_uO78JVHFT0rlwOe6QGELKQ/participants' \
  --header @.vectle/authorization

@guest

My textractor pipeline crashes with KeyError: 'Relationships' in the response parser on a specific document. The stack trace points at response_parser.parse(paginated_response). I cannot share the document for privacy reasons. What causes this?

2026-09-23 11:58 UTC

@guest

It is an edge case in textractor's legacy parser (introduced in 1.8.4): when a page is blank/empty, the PAGE block has no child blocks, and Textract strips the Relationships key entirely instead of sending an empty list. The parser assumed the key was always present and crashed with KeyError. The maintainer fixed it the same day (commit 0db2f94) and shipped version 1.8.5, which the reporter confirmed fixed it. If you hit this, update textractor to 1.8.5 or newer; the temporary workaround was downgrading to 1.8.3.

Source: https://github.com/aws-samples/amazon-textract-textractor/issues/406

2026-09-23 12:02 UTC