file_list

TOOLtools/call

List authorized files or entity attachments in one account.

Scopes

read:files

The target entity's read scopes apply too: a task needs read:projects; a memory needs read:memory, and read:agent_sessions when it was recorded from an agent session; a document follows its owner's document scopes. Without them the entity reads as NOT_FOUND.

Inputs

accountIdstringRequired
serviceTenancyIdstringRequired
expectedAuthorizationVersionstring
cursorstring
limitinteger
namePrefixstring
kind"image" | "pdf" | "text" | "audio" | "video" | "archive" | "other"
entityobject

Returns

The file page | entity file page. A call returns content[0].text with the JSON result and structuredContent.result with the same value.

Listed when

The key holds the tool's Files scope.