取得

要件	値
ログインの有無	True
エンドポイント	/v1/folders/:id
メソッド	GET

概要

指定 ID のフォルダーを単体取得する。認証済みユーザーが所有者である未削除フォルダーのみ返す。

論理削除済みレコードは対象外のため、レスポンスに is_deleted / deleted_at は含めない。

必要なデータ

Headers

ヘッダー	必須	説明
`Cookie`	はい	セッション ID

Path parameters

キー	値の種類	必須	説明
`id`	UUID	はい	フォルダー ID

Query / Body — なし

レスポンス

ステータス	条件
`200 OK`	正常

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Documents",
  "folder_id": null,
  "owner": {
    "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "username": "alice",
    "avatar_url": null
  },
  "created_at": "2026-06-01T10:00:00+09:00",
  "updated_at": "2026-06-01T10:00:00+09:00"
}

Folder オブジェクトのフィールド

フィールド	型	説明
`id`	UUID (string)	フォルダー ID
`name`	string	フォルダー名
`folder_id`	UUID \| null	親フォルダー ID。`null` はルート直下
`owner`	OwnerInfo	所有者の基本情報
`created_at`	string (ISO 8601)	作成日時
`updated_at`	string (ISO 8601)	更新日時

OwnerInfo オブジェクト

フィールド	型	説明
`id`	UUID (string)	ユーザー ID
`username`	string	ユーザー名
`avatar_url`	string \| null	アバター画像 URL

エラーケース

HTTP	code	条件
400	`INVALID_INPUT`	`id` が UUID 形式でない
401	`UNAUTHORIZED`	未認証
404	`NOT_FOUND`	存在しない、論理削除済み、または他ユーザーのフォルダー

実装要件

フィルタ: owner_id = セッション user_id AND is_deleted = false AND id = :id（owner_id が一致しない場合も存在秘匿のため 404 NOT_FOUND を返す）
users テーブルを JOIN して id / username / avatar_url を取得し OwnerInfo を組み立てる（email / is_suspended / password_hash 等の内部情報は含めない）
実装時に OwnerInfo DTO（または同等の struct）を models/ に定義すること
エラー形式: エラーレスポンスに準拠
必要コンポーネント: PostgreSQL