22. 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"
Ответ (201 Created
):
Ответ содержит созданный токен регистрации.
{
"token": "ghr_1234567890abcdef1234567890abcdef12345678"
}
Формат ответа: application/vnd.gitverse.object+json;version=1
Коды ответов
Код | Статус | Описание |
---|---|---|
201 | Created | Токен регистрации успешно создан |
400 | Bad Request | Некорректные параметры запроса |
403 | Forbidden | Доступ запрещен |
404 | Not Found | Организация не найдена |
500 | Internal Server Error | Внутренняя ошибка сервера |
Примечания:
- убедитесь, что ключ API указан корректно и обладает необходимыми правами для доступа к организации;
- токен является временными и используется для регистрации нового раннера.