メインコンテンツへスキップ
GET /api/v1/cloud/files/{file_id} 単一のファイルオブジェクトを取得します。deleted ステータスのファイルはこのエンドポイントでは返されません。

​
パスパラメータ

パラメータ型必須説明
file_idstringはいファイル ID（file_ プレフィックス）

​
ヘッダー

ヘッダー必須説明
AuthorizationはいBearer $QODER_PAT

​
リクエスト例

curl -X GET "https://api.qoder.com/api/v1/cloud/files/file_019e3bb8c1387743bf4ef115aae5acb1" \
  -H "Authorization: Bearer $QODER_PAT"

​
レスポンス例

HTTP 200 OK 
{
  "id": "file_019e3bb8c1387743bf4ef115aae5acb1",
  "type": "file",
  "filename": "qoder-test-upload.txt",
  "mime_type": "text/plain",
  "size_bytes": 110,
  "downloadable": true,
  "scope": {
    "id": "sess_019e3bb8e6c47d18",
    "type": "session"
  },
  "metadata": {
    "project": "demo"
  },
  "created_at": "2026-05-18T15:33:44Z"
}

​
レスポンスフィールド

フィールド型説明
idstringファイル ID（file_ プレフィックス）
typestring常に "file"
filenamestring保存されたファイル名
size_bytesintegerファイルサイズ（バイト）
mime_typestringアップロード時に指定された MIME タイプ、またはファイル名から検出された MIME タイプ
downloadablebooleanこのファイルを /content エンドポイント経由でダウンロードできるかどうか
scopeobject | nullファイルが他のリソースに関連付けられている場合のスコープオブジェクト。例: { "id": "sess_...", "type": "session" }
metadataobjectアップロード時に指定するカスタムメタデータオブジェクト。デフォルトは {}
created_atstring作成時刻（RFC 3339 形式の UTC）

​
エラーレスポンス

HTTPtype説明
401authentication_error認証トークンが欠落または無効
404not_found_error指定 ID のファイルが存在しないか deleted ステータス
エラーで完全なエラーエンベロープを参照してください。

​
関連項目

ファイルの添付とダウンロード

Agent にコンテキストを提供するファイルをアップロードし、Agent が生成したファイルをダウンロードします。