# n8n REST API Methods Checklist

**Версия:** 0.9.0 | **Дата:** 2025-12-26

Быстрый справочник по реализованным методам n8n REST API в MCP сервере.

---

## Легенда статусов

| Символ | Значение |
|--------|----------|
| ✅ | Полностью реализовано и работает |
| ⚠️ | Реализовано с ограничениями (guidance/информационные сообщения) |
| ❌ | Не реализовано |

---

## 📋 Workflows API

| # | HTTP Метод | Endpoint | MCP Tool | Статус | Примечания |
|---|------------|----------|----------|--------|------------|
| 1 | GET | `/workflows` | `list_workflows` | ✅ | Оптимизировано, возвращает только метаданные |
| 2 | GET | `/workflows/{id}` | `get_workflow` | ✅ | Полная структура workflow |
| 3 | POST | `/workflows` | `create_workflow` | ✅ | Валидация + трансформация connections |
| 4 | PUT | `/workflows/{id}` | `update_workflow` | ✅ | Полная замена workflow |
| 5 | PATCH | `/workflows/{id}` | `patch_workflow` | ✅ | Частичное обновление |
| 6 | DELETE | `/workflows/{id}` | `delete_workflow` | ✅ | Безвозвратное удаление |
| 7 | PUT | `/workflows/{id}/activate` | `activate_workflow` | ⚠️ | n8n API ограничение - только через UI |
| 8 | PUT | `/workflows/{id}/deactivate` | `deactivate_workflow` | ⚠️ | n8n API ограничение - только через UI |

**Покрытие:** 6/8 полностью (75%), 2/8 частично (25%)

---

## 📋 Executions API

| # | HTTP Метод | Endpoint | MCP Tool | Статус | Примечания |
|---|------------|----------|----------|--------|------------|
| 1 | GET | `/executions` | `list_executions` | ✅ | Фильтры: status, workflowId, пагинация |
| 2 | GET | `/executions/{id}` | `get_execution` | ✅ | Опция includeData для полных данных |
| 3 | DELETE | `/executions/{id}` | `delete_execution` | ✅ | Безвозвратное удаление |
| 4 | POST | `/executions/{id}/retry` | `retry_execution` | ✅ | Только для status=error |

**Покрытие:** 4/4 полностью (100%)

**Дополнительно:**
- `execute_workflow` - ⚠️ Информационное сообщение (n8n API не поддерживает прямое выполнение)

---

## 📋 Credentials API

| # | HTTP Метод | Endpoint | MCP Tool | Статус | Примечания |
|---|------------|----------|----------|--------|------------|
| 1 | GET | `/credentials` | `list_credentials` | ✅ | Только метаданные, без секретов |
| 2 | GET | `/credentials/{id}` | `get_credential` | ⚠️ | Guidance - n8n блокирует для безопасности |
| 3 | POST | `/credentials` | `create_credential` | ✅ | Автоматическое шифрование |
| 4 | PUT | `/credentials/{id}` | `update_credential` | ⚠️ | Guidance - использовать DELETE + CREATE |
| 5 | DELETE | `/credentials/{id}` | `delete_credential` | ✅ | Безвозвратное удаление |
| 6 | GET | `/credentials/schema/{typeName}` | `get_credential_schema` | ✅ | JSON schema для типов credentials |

**Покрытие:** 4/6 полностью (67%), 2/6 частично (33%)

---

## 📋 Tags API

| # | HTTP Метод | Endpoint | MCP Tool | Статус | Примечания |
|---|------------|----------|----------|--------|------------|
| 1 | GET | `/tags` | `get_tags` | ✅ | Пагинация, все tags |
| 2 | GET | `/tags/{id}` | `get_tag` | ✅ | Конкретный tag по ID |
| 3 | POST | `/tags` | `create_tag` | ✅ | Уникальное имя обязательно |
| 4 | PUT | `/tags/{id}` | `update_tag` | ✅ | Обновление названия |
| 5 | DELETE | `/tags/{id}` | `delete_tag` | ✅ | Удаление из всех workflows |

**Покрытие:** 5/5 полностью (100%)

---

## 🎯 Общая статистика

| Категория | Полностью | Частично | Не реализовано | Всего | % Полного покрытия |
|-----------|-----------|----------|----------------|-------|--------------------|
| Workflows | 6 | 2 | 0 | 8 | 75% |
| Executions | 4 | 0 | 0 | 4 | 100% |
| Credentials | 4 | 2 | 0 | 6 | 67% |
| Tags | 5 | 0 | 0 | 5 | 100% |
| **ИТОГО** | **19** | **4** | **0** | **23** | **83%** |

---

## ⚠️ Известные ограничения n8n API

### 1. Workflows: Activate/Deactivate (⚠️)
- **Методы:** `activate_workflow`, `deactivate_workflow`
- **Причина:** n8n API v2.0.3 не поддерживает программную активацию
- **Решение:** Использовать n8n web interface
- **Статус в коде:** Возвращает информационное сообщение

### 2. Credentials: GET by ID (⚠️)
- **Метод:** `get_credential`
- **Причина:** Безопасность - секретные данные не доступны через API
- **Решение:** Использовать `list_credentials` для метаданных
- **Статус в коде:** Возвращает guidance сообщение

### 3. Credentials: UPDATE (⚠️)
- **Метод:** `update_credential`
- **Причина:** Immutability pattern для защиты секретов
- **Решение:** DELETE старый + CREATE новый credential
- **Статус в коде:** Возвращает guidance сообщение

### 4. Workflows: Execute (ℹ️)
- **Метод:** `execute_workflow`
- **Причина:** n8n API не поддерживает прямое выполнение workflows
- **Решение:**
  - Использовать n8n UI
  - Конвертировать в Webhook/Schedule Trigger
- **Статус в коде:** Возвращает детальное руководство

---

## 📚 Быстрые ссылки

- [Детальный анализ покрытия API](./API-COVERAGE-ANALYSIS.md)
- [n8n API Documentation (local)](./n8n-api-docs/)
- [Project Repository](https://github.com/salacoste/mcp-n8n-workflow-builder)

---

## 🔄 Changelog

| Дата | Версия | Изменения |
|------|--------|-----------|
| 2025-12-26 | 0.9.0 | Первичная версия checklist |

---

**Последнее обновление:** 2025-12-26