REST Endpoints

Усі endpoints використовують базовий URL https://api.hashee.ai. Автентифікація через Authorization: Bearer {token}, якщо не позначено як публічний.

Auth

Метод	Шлях	Auth	Опис
POST	/auth/register	Публічний	Реєстрація нового облікового запису
POST	/auth/login	Публічний	Вхід паролем
POST	/auth/login-code	Публічний	Вхід кодом підтвердження
POST	/auth/send-code	Публічний	Надсилання коду підтвердження
POST	/auth/refresh	Cookie	Оновлення access token
POST	/auth/logout	JWT	Вихід з поточної сесії
POST	/auth/reset-password	Публічний	Скидання пароля облікового запису
POST	/auth/change-password	JWT	Зміна пароля облікового запису
POST	/auth/change-protection-password	JWT	Зміна захисного пароля
GET	/auth/me	JWT	Отримання профілю поточного користувача
POST	/auth/passkey/begin	Публічний	Початок входу через Passkey
POST	/auth/passkey/complete	Публічний	Завершення входу через Passkey
POST	/auth/passkey/register/begin	JWT	Початок реєстрації Passkey
POST	/auth/passkey/register/complete	JWT	Завершення реєстрації Passkey
GET	/auth/passkey/credentials	JWT	Список облікових даних Passkey
PATCH	/auth/passkey/credentials/:id	JWT	Перейменування Passkey
DELETE	/auth/passkey/credentials/:id	JWT	Видалення Passkey

Users

Метод	Шлях	Auth	Опис
GET	/users/me	JWT	Отримання власного профілю
PATCH	/users/me	JWT	Оновлення власного профілю
GET	/users/:id	JWT	Отримання користувача за ID
GET	/users/search	JWT	Пошук користувачів
DELETE	/users/me	JWT	Деактивація та видалення облікового запису
PATCH	/users/contacts/:id	JWT	Встановлення псевдоніма контакту

E2EE Keys

Метод	Шлях	Auth	Опис
POST	/keys/backup	JWT	Завантаження зашифрованої резервної копії ключів
GET	/keys/backup	JWT	Скачування резервної копії ключів
PUT	/keys/backup	JWT	Оновлення резервної копії ключів
GET	/keys/users/:id/devices	JWT	Отримання публічних ключів пристроїв користувача
GET	/keys/agents/:id	JWT	Отримання публічного ключа агента
GET	/keys/groups/:id	JWT	Отримання ключа шифрування групи
POST	/keys/groups/:id/rotate	JWT	Ротація групового ключа
POST	/keys/rotation/request	JWT	Запит ротації ключа H2H
POST	/keys/rotation/confirm	JWT	Підтвердження ротації ключа H2H
POST	/agents/:id/keys/register	Agent	Реєстрація публічного ключа агента

Conversations

Метод	Шлях	Auth	Опис
GET	/conversations	JWT	Список розмов
PATCH	/conversations/:id	JWT	Оновлення налаштувань розмови
DELETE	/conversations/:id	JWT	Приховання розмови
POST	/conversations/:id/read	JWT	Позначити як прочитане
GET	/conversations/:id/messages	JWT	Отримання історії повідомлень
GET	/conversations/:id/media	JWT	Отримання медіа в розмові
PUT	/conversations/:id/draft	JWT	Збереження чернетки
GET	/conversations/:id/draft	JWT	Отримання чернетки
DELETE	/conversations/:id/draft	JWT	Видалення чернетки

Messages

Метод	Шлях	Auth	Опис
POST	/conversations/:id/messages	JWT	Надсилання повідомлення
POST	/messages/:id/recall	JWT	Відкликання повідомлення
POST	/messages/:id/reactions	JWT	Додавання/видалення реакції
GET	/messages/:id/reactions	JWT	Отримання списку реакцій
POST	/messages/forward	JWT	Пересилання повідомлень (макс. 10 цілей)
PATCH	/messages/:id/artifact	Agent	Оновлення Artifact

Groups

Метод	Шлях	Auth	Опис
POST	/groups	JWT	Створення групи
GET	/groups/:id	JWT	Отримання деталей групи
PATCH	/groups/:id	JWT	Оновлення налаштувань групи
DELETE	/groups/:id	JWT	Видалення групи
GET	/groups/:id/members	JWT	Список учасників
POST	/groups/:id/members	JWT	Додавання учасників
DELETE	/groups/:gid/members/:mid	JWT	Видалення учасника
PATCH	/groups/:gid/members/:mid	JWT	Оновлення ролі учасника
PATCH	/groups/:gid/members/me	JWT	Оновлення власного групового профілю
POST	/groups/:gid/leave	JWT	Вихід з групи
POST	/groups/:id/transfer	JWT	Передача права власності
POST	/groups/:gid/join	JWT	Приєднання до групи через share code
GET	/groups/:gid/join-requests	JWT	Список очікуваних запитів
POST	/groups/:gid/join-requests/:uid/approve	JWT	Затвердження запиту
POST	/groups/:gid/join-requests/:uid/reject	JWT	Відхилення запиту
POST	/groups/:id/pinned-messages	JWT	Закріплення повідомлення
GET	/groups/:id/pinned-messages	JWT	Список закріплених повідомлень
DELETE	/groups/:gid/pinned-messages/:mid	JWT	Відкріплення повідомлення
POST	/groups/:gid/members/:mid/mute	JWT	Вимкнення звуку учасника
POST	/groups/:id/agent-instances	JWT	Додавання агента до групи
DELETE	/groups/:gid/agent-instances/:iid	JWT	Видалення агента з групи

Agent Management (Творець)

Метод	Шлях	Auth	Опис
POST	/agents	JWT	Створення агента
GET	/agents	JWT	Список власних агентів
GET	/agents/:id	JWT	Отримання деталей агента
PATCH	/agents/:id	JWT	Оновлення профілю агента
DELETE	/agents/:id	JWT	Видалення агента
GET	/agents/check-id	JWT	Перевірка доступності ID
GET	/agents/:id/token	JWT	Отримання токена агента
POST	/agents/:id/token/regenerate	JWT	Регенерація токена
GET	/agents/:id/commands	JWT	Отримання slash-команд
POST	/agents/:id/commands	JWT	Оновлення slash-команд
GET	/agents/:id/invite-codes	JWT	Список кодів запрошень
POST	/agents/:id/invite-codes	JWT	Створення коду запрошення
PATCH	/invite-codes/:id	JWT	Оновлення коду запрошення
GET	/agents/:id/requests	JWT	Список запитів користувачів
POST	/agents/:id/requests/:rid/approve	JWT	Затвердження запиту
POST	/agents/:id/users/:uid/suspend	JWT	Призупинення користувача
POST	/agents/:id/users/:uid/restore	JWT	Відновлення користувача
GET	/agents/:id/governance	JWT	Отримання статусу управління

Agent Endpoints (Agent Token Auth)

Метод	Шлях	Auth	Опис
POST	/agents/:id/conversations/:cid/messages	Agent	Надсилання повідомлення
POST	/agents/:id/typing	Agent	Надсилання індикатора друку
GET	/agents/:id/messages/poll	Agent	Опитування повідомлень
GET	/agents/:id/conversations	Agent	Список розмов
GET	/agents/:id/conversations/:cid/messages	Agent	Отримання повідомлень розмови
POST	/agents/:id/files	Agent	Запит URL для завантаження файлу
PUT	/agents/:id/files/:uploadId/upload	Agent	Завантаження бінарних даних файлу

Files

Метод	Шлях	Auth	Опис
POST	/files/presign	JWT	Запит presigned URL для завантаження
PUT	/files/:upload_id/upload	JWT	Завантаження бінарних даних файлу
POST	/files/confirm	JWT	Підтвердження завантаження з SHA-256

Інше

Метод	Шлях	Auth	Опис
GET	/health	Публічний	Перевірка стану
GET	/search	JWT	Пошук акторів та Artifacts
POST	/reports	JWT	Скарга на агента
POST	/share/friend	JWT	Створення посилання для поширення друга
POST	/share/agent	JWT	Створення посилання для поширення агента
POST	/share/group	JWT	Створення посилання для поширення групи
GET	/share/*	Публічний	Розв’язання посилання поширення

Наступні кроки

• WebSocket Events — Довідник подій реального часу
• Автентифікація — Деталі потоку автентифікації
• Коди помилок — Таблиця кодів помилок