ファイル取得

MCPツール

get_fileGet File

レート制限

Default

スコープ

files:read

ファイルを取得します。

例

curl 'https://api.youvico.com/api/files/FX1234567890ABCD' \
  -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"
    },
    "project": {
      "id": "bdbff5de-96d7-468f-9db0-85fe28bd6b62"
    }
  }
}

リクエスト

パス

idstringrequired

ファイルID

レスポンス

200 OK を返します。

dataobject

ファイル

data.idstring

ファイルID

Example: FX1234567890ABCD

data.createdAtstring

ファイルの作成日時

Example: 2026-09-01 09:00:00.271845

data.updatedAtstring

ファイルの最終更新日時

Example: 2026-09-10 10:30:00.583126

data.namestring

ファイル名

Example: launch-cut.mp4

data.descriptionstring?

ファイル説明

Example: Final review upload

data.modestring

ファイルのソース種別

Possible values: LOCALYOUTUBE

Example: LOCAL

data.mimeTypestring?

MIMEタイプ

Example: video/mp4

data.statusstring

アップロードステータス

Possible values: UPLOADINGUPLOADEDFAILED

Example: UPLOADED

data.tagstring

レビュータグ

Possible values: IN_PROGRESSNEED_REVIEWNEED_EDITON_HOLDAPPROVEDREJECTEDCLOSED

Example: NEED_REVIEW

data.sizenumber

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

Example: 82415032

data.allowRestrictedboolean

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

Example: true

data.folderobject?

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

data.folder.idstring

親フォルダーID

Example: DX1234567890ABCD

data.uploaderobject

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

data.uploader.idstring

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

Example: f6035d1a-29df-4d80-8d72-f1bbdddfb6ff

data.uploader.namestring

アップロードしたユーザーの表示名

Example: Jin Seo

data.uploader.avatarUrlstring?

アップロードしたユーザーのアバターURL

Example: https://files.youvico.com/users/f6035d1a-29df-4d80-8d72-f1bbdddfb6ff/A1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6.avif

data.projectobject

親プロジェクト

data.project.idstring

親プロジェクトID

Example: bdbff5de-96d7-468f-9db0-85fe28bd6b62