對話附件管理 API

使用檔案庫 API 查詢與刪除對話附件，並了解清單可見範圍與到期欄位。

當您需要查詢對話附件時，可使用對話附件 API。清單排除已直接連結檔案庫檔案的附件；自動歸檔會另外建立檔案庫項目，原對話附件仍可能出現在此清單。請勿只靠清單是否有該筆附件判定檔案是否已歸檔。附件如何上傳，請見 Presigned 檔案上傳模式。

存取條件與可見範圍

請以 Authorization: Api-Key <您的 API 金鑰> 驗證身分；金鑰取得方式見快速上手。組織須已開通檔案庫，且呼叫者須具備檔案庫相關權限。組織擁有者可查看組織內符合上述條件的對話附件；其他成員只看得到自己曾在對話中傳送訊息的對話附件。清單按建立時間由新到舊排列。

端點

GET /api/v1/file-library/conversation-attachments/ 列出呼叫者可見的對話附件，DELETE /api/v1/file-library/conversation-attachments/{id}/ 刪除一筆附件；參數與回應欄位見 API 文件列出對話附件與刪除對話附件。

{id} 是清單回傳的附件 ID。刪除會一併移除未共用的儲存檔案，請先確認選中的附件；若其他附件或檔案仍使用同一個儲存物件，該物件會保留。

分頁與清單欄位

清單每頁預設 20 筆，可用 pageSize（也可寫 page_size）調整，最多 100 筆。附件放在回應的 results，請持續依 next 網址讀取下一頁，直到 next 為 null；不要只讀第一頁。

每筆附件的欄位見 API 文件列出對話附件。conversationId 可供串接端對回來源對話。expiresAt 是依清理設定計算的到期時間，格式為 ISO 8601 字串（和 createdAt 的毫秒時間戳記不同），未設定清理生效時間時為 null；若對話已有最後訊息時間，到期時間以該時間為基準，否則以附件建立時間為基準。