Directus (flagbit) icon

Directus (flagbit)

Consume Directus API

Actions118

Revision → List

AI-generated

Overview

This node operation lists revisions from a data source, allowing users to retrieve revision records with various filtering, sorting, and aggregation options. It is useful for scenarios where tracking changes or versions of data entries is needed, such as auditing or version control in content management systems.

Use Case Examples

  1. Retrieve all revisions for a specific collection or item.
  2. List revisions with a limit on the number of results returned.
  3. Apply filters and sorting to get revisions matching certain criteria.
  4. Export the list of revisions in CSV, JSON, or XML format.

Properties

Name Meaning
Return All Whether to return all results or only up to a given limit.
Limit Maximum number of results to return when not returning all.
Split Into Items Whether to output each element of an array as its own item.
JSON/RAW Parameters Whether the query and/or body parameters should be set via the value-key pair UI or JSON/RAW input.
Body Parameters Body parameters as JSON or RAW input, used when JSON/RAW Parameters is enabled.
Additional Fields Additional optional fields to customize the request, including aggregation functions, export options, filtering, sorting, grouping, and metadata.

Output

JSON

  • revisions - Array of revision objects returned from the list operation.

Dependencies

  • Requires connection to a Directus API endpoint with appropriate authentication.

Troubleshooting

  • Ensure the API credentials are correctly configured and have permission to access revisions.
  • Check that the filter and query parameters are correctly formatted JSON when using JSON/RAW parameters.
  • If no results are returned, verify that the filters and search criteria match existing revisions.
  • When exporting data, ensure the file name and format are correctly specified to avoid export errors.

Discussion