Actions31
Overview
This node integrates with the Steuerboard API to list files associated with a specified client. It is useful for workflows that need to retrieve and process file metadata from Steuerboard, such as automating document management, auditing file inventories, or syncing files with other systems.
For example, you could use this node to:
- Retrieve all files belonging to a particular client to generate reports.
- Fetch a limited number of recent files for quick processing.
- Paginate through large sets of files filtered by workspace.
Properties
| Name | Meaning |
|---|---|
| Client ID | The unique identifier of the client whose files you want to list. |
| Return All | Whether to return all available files (true) or limit the number of results (false). |
| Limit | Maximum number of files to return when "Return All" is false. Value between 1 and 100. |
| Filters | Optional filters to narrow down the file list: |
| - Workspace ID | Filter files by a specific workspace ID. |
| - Cursor | Pagination cursor to fetch the next page of results. |
Output
The node outputs JSON data containing an array of file objects retrieved from the Steuerboard API. Each file object typically includes metadata such as file identifiers, names, associated workspace IDs, and other relevant attributes provided by the API.
If pagination is enabled (Return All = true), the node automatically handles fetching multiple pages until all files are retrieved.
The node does not output binary data; it only returns JSON metadata about files.
Dependencies
- Requires an API key credential for authenticating with the Steuerboard API.
- Needs the base URL of the Steuerboard API configured in the credentials.
- The node uses HTTP requests with appropriate headers including the client ID passed in the request headers.
Troubleshooting
- Missing or invalid Client ID: The node requires a valid client ID to list files. Ensure the client ID is correctly set and corresponds to an existing client in Steuerboard.
- API authentication errors: Verify that the API key credential is valid and has sufficient permissions.
- Pagination issues: If using "Return All", ensure the API supports pagination and that the cursor values are handled correctly. Network interruptions during pagination may cause incomplete results.
- Filter misconfiguration: Incorrect workspace IDs or cursor values in filters may result in empty or partial results.
Links and References
- Steuerboard API documentation (for file listing endpoints and parameters)
- n8n documentation on pagination and API integrations