プロジェクトへのユーザー割り当て

メソッド

REST メソッドを採用しています。

HTTP メソッド

PUT: プロジェクトのユーザー割り当てを 1 件作成または更新

命名規則

URI パラメータには snake_case、JSON フィールドには camelCase を使用します。

リクエストとレスポンス

ヘッダー

リクエストヘッダー

• Authorization: Bearer <access_token>
• Content-Type: application/json

URI

/api/v1/projects/{project_id}/users/{user_id}

名前	型	必須	説明
project_id	integer	必須	プロジェクト ID
user_id	integer	必須	ユーザーレコード ID

リクエストボディ

{
  "projectAccess": "2"
}

フィールド	型	必須	説明
projectAccess	string	必須	"1" = 読み取り、"2" = 読み取り・書き込み

レスポンス（200 OK）

作成または更新された有効な割り当てを返します。

認証要件

ユーザーとプロジェクトの読み取り・書き込み権限を持つ管理者 Cognito Bearer トークンが必要です。

例外処理

説明	ステータスコード	ステータス名
不正なアクセス値または組織の不一致	400	Bad Request
トークンが欠落または無効	401	Unauthorized
ユーザーまたはプロジェクトの権限不足	403	Forbidden
ユーザーまたはプロジェクトが見つからない	404	Not Found

処理フロー

1. 管理者セッション、リクエスト、書き込み権限を検証します。
2. 有効なユーザーとプロジェクトが同じ組織に属することを確認します。
3. 割り当てを upsert して返します。

ソース: apps/admin/src/routes/v1/user-project.ts