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
Request
- Base URLhttps://api.roxels.ai (the document declares no server; this is the origin it was published from)
- AuthHTTP bearer
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
attachment_idstring required
Response
Successful Response
unknown required
Changes
No recorded changes to this operation across all 1 revision of this API.