Actions111
- Item Actions
- Webhook Actions
- Collection Actions
- File Actions
- Activity Actions
- Asset Actions
- Authentication Actions
- Extension Actions
- Field Actions
- Folder Actions
- Permission Actions
- Preset Actions
- Relation Actions
- Revision Actions
- Role Actions
- Setting Actions
- User Actions
- Utility Actions
Overview
The Revision - List operation in this custom n8n node retrieves a list of revision records from a connected service (likely Directus, based on the naming). This operation is useful for scenarios where you need to fetch historical changes or versions of data entities. For example, you might use it to:
- Audit changes made to records over time.
- Display a changelog or history to end users.
- Export revision data for backup or analysis.
You can customize the output by filtering, sorting, grouping, and exporting the results in various formats.
Properties
| Name | Meaning |
|---|---|
| Return All | Whether to return all results or only up to a given limit. If set to false, the "Limit" property determines the maximum number of results. |
| Limit | Max number of results to return (only shown if "Return All" is false). Accepts values between 1 and 100. |
| Split Into Items | Whether to output each element of an array as its own item. Useful for further processing in n8n workflows. |
| JSON/RAW Parameters | Whether the query and/or body parameters should be set via the value-key pair UI or as raw JSON. If enabled, you can provide body parameters directly as JSON. |
| Body Parameters | Body parameters as JSON or RAW (only available if "JSON/RAW Parameters" is enabled). Allows advanced customization of the request body. |
| Additional Fields | A collection of optional fields to further customize the query: - Aggregate: Apply aggregation functions (Average, Count, Sum, etc.) on specific fields. - Binary Property for Export Data: Name of the binary property to download export data to. - Deep (JSON): Set nested query parameters. - Export: Save API response as json, csv, or xml. - File Name for Export Data: Specify file name (without extension) for exported data. - Fields: Control which fields are returned. - Filter (JSON): Filter items using conditions. - Group By: Group results by specified fields. - Meta: Specify metadata to include in the response. - Offset: Skip a number of items when fetching data. - Search: Filter items containing a search query. - Sort: Sort returned items; supports ascending, descending, and random order. |
Output
- The node outputs a
jsonfield containing the list of revision records matching your criteria. - If "Split Into Items" is enabled, each revision will be output as a separate item.
- If "Export" is used, the node can output binary data (e.g., CSV, JSON, or XML files) under the specified binary property name.
Dependencies
- Requires access to a Directus (or compatible) API endpoint.
- May require authentication credentials (API key, token, etc.), depending on your n8n and Directus setup.
- No additional npm dependencies beyond what is bundled with the node.
Troubleshooting
- Authentication Errors: Ensure that your API credentials are correctly configured in n8n.
- Invalid JSON: When using "Body Parameters" or "Filter (JSON)", ensure your JSON syntax is valid.
- Limit Exceeded: If you request more than the allowed maximum (100), reduce the "Limit" value.
- Export Issues: If exporting data, make sure the "Binary Property for Export Data" and "File Name for Export Data" are set appropriately.