Объекты
ApiKeyScope
Область доступа ключа API. Каждая публичная операция объявляет свою тонкую область вида resource:action в расширении x-scope: cards:read и cards:write охватывают карточки, коллекции и папки; search и ask — поиск и вопросы; import:write — свои источники; webhooks:manage — вебхуки и ленту событий; users:read и users:write — пользователей и группы; analytics:read и audit:read — аналитику и журнал аудита; finance:read и catalog:read — финансовые запросы и каталог сервисов; files:read и files:write — файлы; permissions:manage — права на объекты; admin охватывает все области, включая настройки организации и ключи. Прежние области read, write и admin продолжают работать: read означает cards:read, search, ask, users:read, analytics:read, finance:read, catalog:read, files:read; write — набор read плюс cards:write, files:write, users:write, permissions:manage; admin — все области. system бывает только у ключей служебной организации.
Поля
Допустимые значения: readwriteadminsystemcards:readcards:writesearchaskimport:writewebhooks:manageusers:readusers:writeanalytics:readaudit:readfinance:readcatalog:readfiles:readfiles:writepermissions:manage