File を検索

POST /api/v1/cloud/files/search x-qoder-beta: search-2026-08-31 が必要です。すべての任意パラメーターは JSON Body に指定します。URL Query パラメーターは無視されます。

パラメーター	型	説明
`metadata`	object<string,string>	metadata の完全一致条件。複数の条件は AND で結合
`limit`	integer	ページサイズ
`page`	string	`next_page` で返されるカーソル
`name`	string	ファイル名の部分一致（大文字と小文字を区別しない）
`scope_id`	string	リソースの Scope ID。現在は Session ID

curl -X POST "https://api.qoder.com/api/v1/cloud/files/search" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN" -H "Content-Type: application/json" \
  -H "x-qoder-beta: search-2026-08-31" \
  -d '{"metadata":{"project":"demo"},"name":"report","limit":20}'

レスポンス

フィールド	型	説明
`data`	array	現在のページのリソース。各リソースのフィールドは対応する List エンドポイントを参照
`first_id`	string \| null	現在のページの最初のリソース ID
`last_id`	string \| null	現在のページの最後のリソース ID
`has_more`	boolean	次のページがあるかどうか
`next_page`	string \| null	次のページのカーソル。次のページがない場合は `null`
`total`	integer \| null	最初のページではフィルターに一致するリソース総数。`page` 使用時は `null`

{
  "data": [],
  "first_id": null,
  "has_more": false,
  "last_id": null,
  "next_page": null,
  "total": 0
}

data のリソースフィールドはFile 一覧と同じです。metadata の key は 1〜64 文字、value は最大 512 文字の文字列です。デフォルトの処理中リクエスト上限は 10 で、超過すると 429 rate_limit_error が返されます。

​レスポンス

レスポンス