diff --git a/docs/api.md b/docs/api.md
index 39fb6c7..d33f5c2 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -385,6 +385,18 @@
 
 ---
 
+#### `profile_switched`
+```json
+{
+  "type": "profile_switched",
+  "profile_id": "server_admin",
+  "profile_name": "Server Administrator"
+}
+```
+Агент переключил профиль сессии через инструмент `switch_profile`. Новый профиль (набор инструментов и system prompt) вступит в силу с **следующего** пользовательского сообщения. Клиент должен обновить заголовок и прочие UI-элементы, отображающие текущий профиль. Событие приходит во время стрима — до завершения `tool_call` для `switch_profile`.
+
+---
+
 #### `context_compressed`
 ```json
 {
@@ -444,6 +456,16 @@
 stream_end
 ```
 
+**Переключение профиля (`switch_profile`):**
+```
+stream_start
+tool_started          (switch_profile)
+profile_switched      (до tool_call — клиент обновляет UI здесь)
+tool_call             (switch_profile завершён)
+stream_delta × N      (Нavi сообщает о смене профиля)
+stream_end
+```
+
 ---
 
 ## Файлы