From 90c2bdcd96b55de20bb802c94667514fa53fdc02 Mon Sep 17 00:00:00 2001
From: benya <benya@daemonlord.ru>
Date: Sun, 8 Mar 2026 20:18:18 +0300
Subject: [PATCH] docs(api): document owner-only chat role update rules

---
 docs/api-reference.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/api-reference.md b/docs/api-reference.md
index c22c7df..3c1960d 100644
--- a/docs/api-reference.md
+++ b/docs/api-reference.md
@@ -788,6 +788,11 @@ Body:
 
 Response: `200` + `ChatMemberRead`
 
+Rules:
+
+- only `owner` can change member roles.
+- owner cannot demote self from `owner`.
+
 ### DELETE `/api/v1/chats/{chat_id}/members/{user_id}`
 
 Auth required.