GitHub открыл REST API для управления AI Scan репозиториев

Какие настройки доступны через API

Параметр принимает enabled или disabled. Читать и менять его можно на уровне организации через /orgs/{org}/code-scanning/ai-scan, а на уровне репозитория через /repos/{owner}/{repo}/code-scanning/ai-scan. Чтение использует GET, изменение PATCH.

В одном запросе допускается передать и repository_scan, и pr_scan для проверок pull request. Если изменение одного параметра запрещено, сервер возвращает 422 и не меняет ни один из двух. Это важно учитывать при обработке ответа в сценарии автоматизации.

Как действуют политики и права

Запрет на уровне организации не позволяет включить AI Scan репозитория отдельно. При включении на уровне организации репозитории наследуют настройку и могут отказаться от неё индивидуально. Политика предприятия также должна разрешать AI Scan.

Настройкой организации управляют её владельцы и security managers. В документации REST API отдельно указаны права для используемого типа токена: например, fine-grained доступу для изменения настройки организации требуется право Administration организации на запись. Настройка отдельного репозитория требует соответствующего права его администрирования.

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

Включённый параметр не начинает сканирование. Пользователь с правом записи запускает его отдельно по запросу, и каждая проверка расходует GitHub Code Security AI credits. Поэтому успешный PATCH подтверждает изменение конфигурации, но не завершённый анализ кода.

Возможность доступна для публичных репозиториев организаций, а для приватных и внутренних нужны GitHub Code Security или GitHub Advanced Security. GitHub Enterprise Server не поддерживается. Новое управление остаётся предварительной публичной возможностью.

С чего начать проверку автоматизации

Сначала прочитайте текущие настройки организации и выбранного тестового репозитория. Затем проверьте разрешённое изменение и отдельно обработку отказа 422. Повторное чтение после PATCH поможет подтвердить фактическое состояние, а запуск сканирования и его результат учитывайте отдельно.

Управление конфигурацией через API можно закрепить на практике DevOps. Границы прав и обработку ошибок в своём сценарии разберите с наставником по DevOps.