ファイル一覧

GEThttps://api.youvico.com/api/projects/:id/files

MCPツール: list_filesList Files
レート制限: Tier 3
スコープ: files:read

プロジェクトのファイル一覧を取得します。

例

curl 'https://api.youvico.com/api/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/files' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "data": [
    {
      "id": "FX1234567890ABCD",
      "createdAt": "2026-09-01 09:00:00.271845",
      "updatedAt": "2026-09-10 10:30:00.583126",
      "name": "launch-cut.mp4",
      "description": "Final review upload",
      "mode": "LOCAL",
      "mimeType": "video/mp4",
      "status": "UPLOADED",
      "tag": "NEED_REVIEW",
      "size": 82415032,
      "allowRestricted": true,
      "folder": {
        "id": "DX1234567890ABCD"
      },
      "uploader": {
        "id": "f6035d1a-29df-4d80-8d72-f1bbdddfb6ff",
        "name": "Jin Seo",
        "avatarUrl": "https://files.youvico.com/users/f6035d1a-29df-4d80-8d72-f1bbdddfb6ff/A1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6.avif"
      }
    }
  ]
}

リクエスト

curl -X GET 'https://api.youvico.com/api/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/files' \

-H 'Authorization: Bearer YOUR_API_KEY'

レスポンス200 OK

{
  "data": [
    {
      "id": "FX1234567890ABCD",
      "createdAt": "2026-09-01 09:00:00.271845",
      "updatedAt": "2026-09-10 10:30:00.583126",
      "name": "launch-cut.mp4",
      "description": "Final review upload",
      "mode": "LOCAL",
      "mimeType": "video/mp4",
      "status": "UPLOADED",
      "tag": "NEED_REVIEW",
      "size": 82415032,
      "allowRestricted": true,
      "folder": {
        "id": "DX1234567890ABCD"
      },
      "uploader": {
        "id": "f6035d1a-29df-4d80-8d72-f1bbdddfb6ff",
        "name": "Jin Seo",
        "avatarUrl": "https://files.youvico.com/users/f6035d1a-29df-4d80-8d72-f1bbdddfb6ff/A1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6.avif"
      }
    }
  ]
}

リクエスト

パス

idstringrequired

プロジェクトID

レスポンス

200 OK を返します。

dataarray

ファイル

data[].idstring

ファイルID

例: FX1234567890ABCD

data[].createdAtstring

ファイルの作成日時

例: 2026-09-01 09:00:00.271845

data[].updatedAtstring

ファイルの最終更新日時

例: 2026-09-10 10:30:00.583126

data[].namestring

ファイル名

例: launch-cut.mp4

data[].descriptionstring?

ファイル説明

例: Final review upload

data[].modestring

ファイルモード

指定できる値: LOCALYOUTUBE

例: LOCAL

data[].mimeTypestring?

MIMEタイプ

例: video/mp4

data[].statusstring

ファイルステータス

指定できる値: UPLOADINGUPLOADEDFAILED

例: UPLOADED

data[].tagstring

レビュータグ

指定できる値: IN_PROGRESSNEED_REVIEWNEED_EDITON_HOLDAPPROVEDREJECTEDCLOSED

例: NEED_REVIEW

data[].sizenumber

ファイルサイズ（バイト）

例: 82415032

data[].allowRestrictedboolean

制限付きレビュアーがこのファイルにアクセスできるかどうか

例: true

data[].folderobject?

親フォルダー。プロジェクトルートでは null

data[].uploaderobject

アップロードしたユーザー