29. POST /orgs/{org}/actions/runners/registration-token — создать токен регистрации раннера для организации

Описание

Этот метод генерирует временный токен, который может быть использован для регистрации нового локального раннера организации. Только пользователи с правами администратора организации могут создать токен.

Параметры URL:

ПараметрОбязательныйОписание
orgДаНазвание организации

Тело запроса:

Данный метод не требует тела запроса.

Пример запроса:

curl -X POST "https://api.gitverse.ru/orgs/myorg/actions/runners/registration-token" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/vnd.gitverse.object+json;version=1"

Ответ (201 Created):

Ответ содержит созданный токен регистрации.

{
  "token": "<registration_token>"
}

Формат ответа: application/vnd.gitverse.object+json;version=1

Коды ответов

КодСтатусОписание
201CreatedТокен регистрации успешно создан
400Bad RequestНекорректные параметры запроса
401UnauthorizedНеобходима авторизация
403ForbiddenДоступ запрещен
404Not FoundОрганизация не найдена
429Too Many RequestsПревышен лимит запросов
500Internal Server ErrorВнутренняя ошибка сервера

Примечания:

  • убедитесь, что токен API указан корректно и обладает необходимыми правами для доступа к организации;
  • токен является временным и используется для регистрации нового раннера.