Подключите свои дела.
REST API и MCP дают выбранному агенту доступ к вашим деревьям. Начните с токена для чтения; добавляйте права записи только когда они нужны.
Начало работы
Создайте персональный токен в настройках агентов. Его значение показывается один раз; срок и права можно выбрать, а доступ — отозвать.
Спецификация OpenAPI 3.1 · Инструкция для агентов
Права токена
- read — чтение деревьев, задач, заметок, поиск и экспорт.
- write — создание, изменение и удаление данных. В Seed API доступен для чтения; запись требует Sprout или Grove.
- attachments — доступ к содержимому вложений дополнительно к read. Загрузка требует также write. Подписанная ссылка действует не более 5 минут.
REST API
Передавайте токен в заголовке Authorization. Лимит — 600 запросов в минуту на токен; при 429 соблюдайте Retry-After.
curl https://taskwood.dzenity.com/api/v1/trees \
-H "Authorization: Bearer YOUR_TOKEN"
GET /api/v1/trees/{id}/export
GET /api/v1/tasks?updated_since=2026-10-07T00%3A00%3A00Z
GET /api/v1/search?q=Taskwood
POST /api/v1/tasks
PATCH /api/v1/tasks/{id}Списки возвращают items и next_cursor, по умолчанию 100 записей, максимум 200. Повторяйте запрос с теми же фильтрами и limit, добавляя cursor, до next_cursor: null.
GET /trees/{id}/export возвращает полный снимок дерева с проектами и задачами. Списки используют стабильный порядок создания; редактирование и удаление во время обхода не образуют неизменяемый снимок.
Фильтр updated_since принимает ISO 8601 с часовым поясом и включает пограничное время. Удаления не возвращаются как tombstone; для сверки удалённых данных обновите полный снимок.
Чтение возвращает приватный ETag. Заголовок If-None-Match позволяет получить 304. Данные API не сохраняются в публичном кэше.
Для повторяемой записи передавайте уникальный Idempotency-Key. Сохраняйте его при сетевом повторе с тем же методом, адресом и телом; другое тело с тем же ключом вернёт 409. Ответ хранится 7 дней. Создание токена не поддерживает этот ключ.
MCP
Адрес /mcp использует Streamable HTTP с JSON-ответами. Клиент передаёт тот же Bearer-токен, выполняет initialize и сохраняет полученный Mcp-Session-Id. Обычный MCP-клиент делает это автоматически.
https://taskwood.dzenity.com/mcp
Authorization: Bearer YOUR_TOKENДоступные инструменты: list_trees, list_tasks, get_task, search, create_task, complete_task, get_attachment, transcribe_audio. Инструменты записи видны только при соответствующих правах и тарифе. Ресурс taskwood://tree/{id} содержит полный снимок дерева.
Загрузите файл через POST /tasks/{id}/attachments (multipart, до25 МиБ). Содержимое доступно через GET /attachments/{id}/content. Координаты и данные камеры удаляются из фотографий. Перед расшифровкой проверьте GET /speech/status: без подключённого провайдера запрос вернёт503 и не создаст задание. Webhooks ещё готовятся.
Подключение клиентов
Cursor и Claude Code поддерживают заголовок Bearer. Инструкции находятся в настройках агентов. Для прямого подключения ChatGPT и Claude Desktop готовится OAuth.