#564 — Modify /documents endpoint to include document classification

Repo: Twill-AI/facade State: closed | Status: done Assignee: meliascosta, Ahmad1809

Created: 2025-09-06 · Updated: 2025-09-29

Description

Request

Caused by https://twillpayments.atlassian.net/wiki/spaces/TD/pages/431915009/AI+powered+document+processing

In order to know the document class after upload

Acceptance criteria

  • DbMerchantDocument has a new column category to hold the assigned document category and a new column description to hold a summarized or condensed description of the document.
  • The POST /api/v1/partner/merchants/{merchant_id}/documents endpoint has been modified to call the classification function from task https://github.com/Twill-AI/twill-llm-engine/issues/310 and save the category when persisting the doc in our DB
  • The GET /api/v1/partner/merchants/{merchant_id}/documents endpoint has been modified to return the document category
  • Logic above is covered with unit tests.

Notes

Add implementation notes, blockers, and context here

Add wikilinks to related people, meetings, or other tickets