Directus (flagbit) icon

Directus (flagbit)

Consume Directus API

Activity → List

AI-generated

Overview

This node operation lists activities from a data source, allowing users to retrieve multiple activity records with various filtering, sorting, and aggregation options. It is useful for scenarios where you need to fetch activity logs, user actions, or event data for analysis, reporting, or integration with other systems. For example, you can list all activities within a date range, aggregate counts of specific actions, or export the results in CSV format.

Use Case Examples

  1. Fetch all activities without limit to analyze user behavior over time.
  2. Retrieve a limited number of recent activities for a dashboard display.
  3. Export filtered activity data as a CSV file for reporting purposes.

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 when JSON/RAW Parameters is enabled.
Additional Fields Additional optional fields to customize the query, including aggregation functions, export options, filtering, sorting, grouping, and metadata.

Output

JSON

  • data - The list of activity items returned from the query, potentially split into individual items if 'Split Into Items' is enabled.
  • metadata - Additional metadata about the response, such as pagination info or aggregation results.

Dependencies

  • An API key credential or authentication token to access the data source.

Troubleshooting

  • Ensure the API credentials are correctly configured to avoid authentication errors.
  • If no results are returned, verify the filter and search parameters are correctly set and match existing data.
  • When using JSON/RAW parameters, ensure the JSON syntax is valid to prevent parsing errors.
  • If exporting data, confirm the file name and format are correctly specified to avoid file generation issues.

Discussion