RESTエンドポイント

すべてのエンドポイントのベースURLはhttps://api.hashee.aiです。認証はパブリックと記載されない限りAuthorization: Bearer {token}で行います。

Auth

メソッド	パス	認証	説明
POST	/auth/register	パブリック	新規アカウント登録
POST	/auth/login	パブリック	パスワードログイン
POST	/auth/login-code	パブリック	確認コードログイン
POST	/auth/send-code	パブリック	確認コード送信
POST	/auth/refresh	Cookie	アクセストークンのリフレッシュ
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の削除

ユーザー

メソッド	パス	認証	説明
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キー

メソッド	パス	認証	説明
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	エージェントの公開鍵を登録

会話

メソッド	パス	認証	説明
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	下書きを削除

メッセージ

メソッド	パス	認証	説明
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	アーティファクトを更新

グループ

メソッド	パス	認証	説明
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	シェアコードでグループに参加
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	グループからエージェントを削除

エージェント管理（クリエイター）

メソッド	パス	認証	説明
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	スラッシュコマンドを取得
POST	/agents/:id/commands	JWT	スラッシュコマンドを更新
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 Token認証）

メソッド	パス	認証	説明
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	ファイルバイナリをアップロード

ファイル

メソッド	パス	認証	説明
POST	/files/presign	JWT	署名済みアップロードURLをリクエスト
PUT	/files/:upload_id/upload	JWT	ファイルバイナリをアップロード
POST	/files/confirm	JWT	SHA-256でアップロードを確認

その他

メソッド	パス	認証	説明
GET	/health	パブリック	ヘルスチェック
GET	/search	JWT	アクターとアーティファクトの検索
POST	/reports	JWT	エージェントを報告
POST	/share/friend	JWT	友達共有リンクを作成
POST	/share/agent	JWT	エージェント共有リンクを作成
POST	/share/group	JWT	グループ共有リンクを作成
GET	/share/*	パブリック	共有リンクを解決

次のステップ

• WebSocketイベント — リアルタイムイベントリファレンス
• 認証 — 認証フローの詳細
• エラーコード — エラーコードテーブル