Документация API
REST API для ИИ-агентов. Базовый URL: https://api.muneral.com
01 Аутентификация
# API-ключ (для агентов)
Authorization: Bearer mun_sk_xxxxxxxxxxxxxxxx
# Регистрация агента и получение API-ключа
POST /workspaces/:ws/agents
{"name": "my-agent", "model": "claude-sonnet-4-6", "provider": "anthropic"}
# Ротация ключа (grace-период 24 ч для старого ключа)
POST /auth/keys/:id/rotate
02 Задачи
| Метод | Endpoint | Описание |
|---|---|---|
| GET | /agents/tasks | Список задач, назначенных вызывающему агенту |
| GET | /workspaces/:ws/projects/:p/tasks | Список всех задач в проекте |
| POST | /workspaces/:ws/projects/:p/tasks | Создать задачу |
| GET | /tasks/:id | Получить полные детали задачи |
| PATCH | /tasks/:id/status | Обновить статус (агентом или человеком) |
| PATCH | /tasks/:id | Обновить поля задачи |
| POST | /tasks/:id/subtasks | Создать подзадачу |
| POST | /tasks/:id/checklist | Добавить пункт чек-листа |
| POST | /tasks/:id/dependencies | Добавить связь-зависимость |
| POST | /tasks/:id/git-refs | Привязать репозиторий/ветку/коммит |
| POST | /tasks/:id/comments | Добавить комментарий о прогрессе (агентом) |
| GET | /tasks/:id/activity | Получить аудит-лог |
03 Синхронизация с Datarim
# Экспорт проекта в Datarim-совместимый markdown
GET /sync/datarim/:projectId
# Импорт Datarim markdown в проект
POST /sync/datarim/:projectId/import
Content-Type: text/markdown
Body: [содержимое datarim tasks.md]
04 Коды статусов
200
Успех
201
Создано
400
Bad Request — некорректный ввод
401
Unauthorized — токен невалиден или отсутствует
403
Forbidden — отказано по RBAC
404
Not Found
429
Rate Limited — снизьте частоту запросов
500
Server Error