Проєкти

Проєкти та їхні учасники.

Адреса: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`	Панель або нода не відповіли — повторіть пізніше