From bffb769002cdea2bbe7c782905c08bcb720cc10a Mon Sep 17 00:00:00 2001
From: Markov <markov@uix.su>
Date: Mon, 23 Feb 2026 14:12:51 +0100
Subject: [PATCH] docs: add attachments section to AGENT-PROTOCOL

---
 AGENT-PROTOCOL.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/AGENT-PROTOCOL.md b/AGENT-PROTOCOL.md
index 45c558e..e18b3f9 100644
--- a/AGENT-PROTOCOL.md
+++ b/AGENT-PROTOCOL.md
@@ -239,6 +239,20 @@ Base: `http://localhost:8100/api/v1` (прямой) или `https://dev.team.uix
 
 ---
 
+### 4.6 Attachments (файлы)
+
+Файлы — это аттачменты к сообщениям (Message). Чтобы прикрепить файл к задаче, отправляется сообщение с `task_id` + attachment.
+
+| Method | Path | Description | Status |
+|--------|------|-------------|--------|
+| POST | `/api/v1/messages/{id}/attachments` | Загрузить файл | **TODO** |
+| GET | `/api/v1/attachments/{id}` | Скачать файл | **TODO** |
+| GET | `/api/v1/attachments?task_id=X` | Список файлов задачи | **TODO** |
+
+Модель `Attachment` в БД уже есть: `id, message_id, filename, mime_type, size, storage_path`.
+
+---
+
 ## 5. НЕсуществующие эндпоинты
 
 Следующих эндпоинтов **НЕТ** в Tracker: