listFolder
List one level of a Pinata folder to retrieve its files and subdirectories with names, paths, sizes, and CIDs, plus the folder's own CID. Use it to browse folder contents page by page or inspect a subdirectory.
Instructions
List one level of a folder on Pinata (one uploaded with uploadFolder, or any other folder): its files and subdirectories with their names, paths, sizes and CIDs, plus the folder's CID, its root (the name every file path starts with) and whether files can still be added to it (appendable, appendable_until). Pass path to list a subdirectory, and next_page_token as pageToken for the next page.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"folderId": "<folderId>"
},
"name": "listFolder"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | No | Subdirectory to list, relative to the folder root, without the root name (e.g. images/2024). Defaults to the root. | |
| limit | No | Maximum number of entries to return (default 100, at most 1000) | |
| network | No | Network the folder is on; when given, a folder on the other network is not found | |
| folderId | Yes | ID of the folder (the id returned by uploadFolder) | |
| pageToken | No | next_page_token of the previous page |