Создать токен регистрации раннера для организации

POST /orgs/{org}/actions/runners/registration-token

Описание

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

Токен

Требуется токен с правами на Запись для Организации.

Заголовки

ПараметрОбязательныйОписание
acceptНетТип содержимого ответа. Рекомендуется установить значение application/vnd.gitverse.object+json;version=latest

Параметры пути

ПараметрОбязательныйОписание
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Внутренняя ошибка сервера

Пример тела ошибки

При ответе 400 тело ответа имеет следующий вид:

{
  "error": {
    "code": "BAD_REQUEST",
    "documentation_url": "https://gitverse.ru/docs/developers/public-api/",
    "message": "The request format is invalid",
    "status": 400
  }
}

Примечания

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