OptionalfileMaximum number of files to return in files, prioritizing failures (the ones needing attention)
before filling remaining room with other statuses. counts/totalFiles always cover every file
regardless of this cap. Defaults to 50.
The folder subtree, bare filename, or exact file path to search for. A subtree match uses the same
segment-safe matching as $underPath metadata filters; a value containing / also matches that
exact file, so pasting a path from an earlier result finds that one file, not a folder of the same name.
The knowledge base to query.
Request to search and aggregate the durable ingestion status of every file/text context matching
folderPath, read three ways and unioned: a folder subtree, a bare filename anywhere in the knowledge base, and — when it contains a/— an exactfolderPath/filenamepath.