ファイル一覧

GET /v1/files 現在のアカウント配下のファイルを取得します。デフォルトでは deleted ステータスのファイルは除外されます。

ヘッダー

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

クエリパラメータ

パラメータ	型	必須	説明
`limit`	integer	いいえ	1 ページあたりの最大件数。正の整数である必要があり、デフォルト 20、最大 100
`after_id`	string	いいえ	カーソルページネーション：この `file_id` 以降のファイルを返す。`before_id` と排他
`before_id`	string	いいえ	カーソルページネーション：この `file_id` 以前のファイルを返す。`after_id` と排他
`order`	string	いいえ	`created_at` と `id` によるソート方向。`asc` または `desc`、デフォルトは `desc`
`purpose`	string	いいえ	ファイル用途でフィルタ。ファイル用途を参照
`name`	string	いいえ	ファイル名の前方一致検索（大文字小文字を区別しない）
`session_id`	string	いいえ	Session に関連付けられたファイルでフィルタ。`status` を省略した場合、Session スコープのリストは `ready` ファイルのみを返します
`status`	string	いいえ	ファイルステータスでフィルタ。設定するとデフォルトの deleted 除外を上書きします
`include_deleted`	boolean	いいえ	`status` を省略した場合、`true` を設定すると `deleted` ステータスのファイルを含みます

リクエスト例

# 基本一覧
curl -X GET "https://api.qoder.com/api/v1/cloud/files" \
  -H "Authorization: Bearer $QODER_PAT"

# 用途でフィルタ + 件数制限
curl -X GET "https://api.qoder.com/api/v1/cloud/files?purpose=session_resource&limit=10" \
  -H "Authorization: Bearer $QODER_PAT"

# カーソルページネーション
curl -X GET "https://api.qoder.com/api/v1/cloud/files?limit=10&after_id=file_019e3bb8e6c47d18" \
  -H "Authorization: Bearer $QODER_PAT"

レスポンス例

HTTP 200 OK

{
  "data": [
    {
      "created_at": "2026-05-18T15:33:53Z",
      "file_id": "file_019e3bb8e6c47d189212a79642136696",
      "filename": "report.txt",
      "metadata": {
        "project": "test"
      },
      "mime_type": "text/plain",
      "purpose": "session_resource",
      "size_bytes": 110,
      "status": "ready",
      "updated_at": "2026-05-18T15:33:54Z"
    }
  ],
  "first_id": "file_019e3bb8e6c47d189212a79642136696",
  "has_more": false,
  "last_id": "file_019e3bb8e6c47d189212a79642136696"
}

レスポンスフィールド

フィールド	型	説明
`data`	array	ファイルオブジェクトの配列
`first_id`	string \| null	現在ページ先頭ファイルの ID。`data` が空の場合は `null`
`last_id`	string \| null	現在ページ末尾ファイルの ID。`data` が空の場合は `null`
`has_more`	boolean	さらにファイルがあるかどうか

ページネーション

結果は created_at と id でソートされます。ファイルをページングするには:

初回リクエストで limit を設定し、最初のページを取得
has_more が true の場合、after_id=<last_id> で次のページを取得
before_id=<first_id> で前方ページネーションが可能

エラーレスポンス

HTTP	type	説明
400	`invalid_request_error`	`limit` が無効、または `before_id` と `after_id` の両方が指定されている
401	`authentication_error`	認証トークンが欠落または無効

エラーで完全なエラーエンベロープを参照してください。

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

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

​ヘッダー

​クエリパラメータ

​リクエスト例

​レスポンス例

​レスポンスフィールド

​ページネーション

​エラーレスポンス

​関連項目