Работа с Notion через командную строку

Как применить

Рекомендуется использовать официальный CLI ntn; curl применяйте только когда ntn недоступен или когда прямой запрос более понятен.

Рекомендуется использовать официальный CLI ntn; отступайте на curl только когда ntn недоступен или когда прямой запрос более понятен.

Для ввода контента используйте --content, стандартный ввод или редактор в терминале.

Ссылки на родительские элементы можно указывать как page:<id>, database:<id> или data-source:<id>.

Для работы с свойствами, шаблонами и полным API страниц используйте ntn api v1/pages.

Синтаксис ввода в API: path=value — это поле с текстовым содержимым, path:=json — поле с JSON-содержимым определённого типа, name==value — параметр запроса, Header:Value — заголовок запроса, а --data '<json>' или ввод из стандартного потока для JSON используются для передачи больших объёмов данных.

path=value — это поле с текстовым содержимым.

path:=json — это поле с JSON-содержимым определённого типа.

name==value — это параметр запроса.

Header:Value — это заголовок запроса.

Для передачи больших объёмов данных используйте --data '<json>' или ввод из стандартного потока в формате JSON.

Текущая последняя версия API: 2026-03-11.

Используйте in_trash, а не archived.

Для позиционирования блока добавления используйте position, а не плоский вариант after.

Блок transcription был переименован в meeting_notes.

Базы данных могут содержать несколько источников данных, а родительские ссылки на страницы обычно используют data_source_id.

Установите CLI глобально через npm, проверьте версию и войдите в систему.

npm install -g ntn
ntn --version
ntn login

Для скриптов или автоматизированной аутентификации экспортируйте токен API и версию API как переменные окружения.

export NOTION_API_TOKEN=secret_or_ntn_token
export NOTION_API_VERSION=2026-03-11

Проверьте состояние CLI, перечислите доступные конечные точки API, а также просмотрите справку, спецификации или документацию по конкретной конечной точке.

ntn doctor
ntn api ls
ntn api ls --json
ntn api v1/comments --help
ntn api v1/comments --spec -X POST
ntn api v1/comments --docs -X POST

Читайте, создавайте, обновляйте или удаляйте страницы; эти вспомогательные функции ориентированы на Markdown.

Вспомогательные функции для работы со страницами ориентированы на Markdown.

ntn pages get <page-id>
ntn pages get <page-id> --json
ntn pages create --parent page:<page-id> --content '# Title\n\nBody'
ntn pages create --parent data-source:<data-source-id> < page.md
ntn pages update <page-id> --content '# Updated'
ntn pages update <page-id> < page.md
ntn pages trash <page-id> --yes

Определите ID базы данных, чтобы получить её источники данных, и выполните запрос к источнику данных, при необходимости с указанием ограничений, сортировки и фильтров.

ntn datasources resolve <database-id>
ntn datasources resolve <database-id> --json
ntn datasources query <data-source-id>
ntn datasources query <data-source-id> --limit 50 --json
ntn datasources query <data-source-id> --sort 'Date desc'
ntn datasources query <data-source-id> --filter '{"property":"Done","checkbox":{"equals":true}}'

Используйте resolve, если у вас есть ID базы данных; для выполнения запроса требуется ID источника данных.

Вызывайте произвольные конечные точки API Notion напрямую, используя синтаксис встроенного ввода.

ntn api v1/users/me
ntn api v1/search query=roadmap page_size:=10
ntn api v1/pages 'parent[data_source_id]='"$DS_ID" 'properties[Name][title][0][text][content]=New item'
ntn api "v1/pages/$PAGE_ID" -X PATCH in_trash:=true
ntn api "v1/blocks/$PAGE_ID/children" -X PATCH \
  'children[0][type]=paragraph' \
  'children[0][paragraph][rich_text][0][text][content]=Hello'

В одном запросе используйте только один источник данных для тела запроса.

Загрузите файлы из стандартного ввода, файла с указанным именем и типом содержимого или из внешнего URL-адреса, затем получите информацию о загрузках или их список.

ntn files create < image.png
ntn files create --filename photo.png --content-type image/png < /tmp/photo
ntn files create --external-url https://example.com/photo.png
ntn files get <upload-id>
ntn files list

Создавайте, развертывайте и перечисляйте рабочие процессы, а также просматривайте их запуски и журналы.

ntn workers new
ntn workers deploy
ntn workers list --json
ntn workers runs list --json
ntn workers runs logs <run-id>

Для использования рабочих процессов может потребоваться тарифный план Business или Enterprise, а также настройка рабочего пространства.

В качестве альтернативы можно напрямую вызвать API Notion с помощью утилиты curl, передав токен авторизации, версию API и заголовки с информацией о типе содержимого.

curl -sS "https://api.notion.com/v1/users/me" \
  -H "Authorization: Bearer $NOTION_API_TOKEN" \
  -H "Notion-Version: 2026-03-11" \
  -H "Content-Type: application/json"

Текущая последняя версия API: 2026-03-11.