Проекты

Проекты и их участники.

Адрес:https://sourhost.net/api/v1·Авторизация: Authorization: Bearer sh_live_…

GET/projects— Список проектов POST/projects— Создать проект PATCH/projects/:id— Переименовать проект DELETE/projects/:id— Удалить проект POST/projects/:id/members— Добавить участника DELETE/projects/:id/members/:memberId— Убрать участника

GET/projects

Список проектов

Право: projects:read

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

curl "https://sourhost.net/api/v1/projects" \
  -H "Authorization: Bearer $SOURHOST_TOKEN"

Ответ

HTTP

HTTP/2 200 OK
[
  {
    "id": "12",
    "name": "Мой проект",
    "role": "owner",
    "createdAt": "2026-08-07T20:04:03Z",
    "services": 2,
    "monthly": 600,
    "members": [
      {
        "id": "27",
        "email": "[email protected]",
        "owner": true
      }
    ]
  }
]

POST/projects

Создать проект

Право: projects:write

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

curl -X POST "https://sourhost.net/api/v1/projects" \
  -H "Authorization: Bearer $SOURHOST_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Турнир"}'

Ответ

201 Успешный ответ

PATCH/projects/:id

Переименовать проект

Право: projects:write

Параметры

idобязательный path · string Номер проекта (из GET /projects) или тикета

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

curl -X PATCH "https://sourhost.net/api/v1/projects/12" \
  -H "Authorization: Bearer $SOURHOST_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Турнир 2026"}'

Ответ

204 Пустой ответ

DELETE/projects/:id

Удалить проект

Право: projects:delete

Параметры

idобязательный path · string Номер проекта (из GET /projects) или тикета

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

curl -X DELETE "https://sourhost.net/api/v1/projects/12" \
  -H "Authorization: Bearer $SOURHOST_TOKEN"

Ответ

204 Пустой ответ

POST/projects/:id/members

Добавить участника

Право: projects:members

Параметры

idобязательный path · string Номер проекта (из GET /projects) или тикета

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

curl -X POST "https://sourhost.net/api/v1/projects/12/members" \
  -H "Authorization: Bearer $SOURHOST_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]"}'

Ответ

204 Пустой ответ

DELETE/projects/:id/members/:memberId

Убрать участника

Право: projects:members

Параметры

`id`обязательный	path · string	Номер проекта (из GET /projects) или тикета
`memberId`обязательный	path · string	ID участника (из списка)

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

curl -X DELETE "https://sourhost.net/api/v1/projects/12/members/9" \
  -H "Authorization: Bearer $SOURHOST_TOKEN"

Ответ

204 Пустой ответ

Общие ошибки

Любой метод может ответить так. Подробнее об ошибках

400	`bad_request`	Неверное тело или параметры
401	`token_invalid`	Токен неверный, отозван или просрочен
403	`token_scope_missing`	У токена нет нужного права
403	`token_project_forbidden`	Проект или услуга вне ограничений токена
404	`not_found`	Нет такого проекта, услуги или объекта
429	`token_rate_limited`	Слишком много запросов, см. Retry-After
503	`upstream_unavailable`	Панель или нода не ответили — повторите позже