attachments
Reprocess Attachment
Re-run the full attachment pipeline on an existing attachment.
Two use cases:
- Recover a 'failed' row — extraction or a later step crashed, leaving the attachment in a permanent error state. Reprocess re-extracts, re-classifies, and re-indexes from scratch.
- Re-run after schema change — template goals or classifier behavior changed and the attachment's file_role / document_kind should be recomputed.
The endpoint flips status to 'processing', runs the same _process_attachment background-task body the upload path uses, and returns the freshly-updated file_role + document_kind + form_structure.
post/v1/attachments/{attachment_id}/reprocess
Path parameters
attachment_idstring required
Response
Successful Response
{"stackTrail":"paths:/v1/attachments/{attachment_id}/reprocess:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}
Changes
No recorded changes to this endpoint across all 1 revision of this API.