TwentyDEV icon

TwentyDEV

Consume the Twenty API

Actions252

Overview

This node operation, Find Timeline Activity Duplicates, is designed to identify duplicate timeline activities within a dataset. It is useful in scenarios where you want to clean up or analyze timeline data by detecting repeated or redundant entries. For example, if you have multiple timeline activities logged for the same event or action, this operation helps find those duplicates based on specified criteria.

Typical use cases include:

  • Data deduplication before reporting or analytics.
  • Identifying repeated user actions or events in a timeline.
  • Cleaning up imported timeline data by removing duplicates.

Properties

Name Meaning
Depth Determines how much related nested information to include in the response:
- 0: Only the primary timeline activity object.
- 1: Primary object plus its directly related objects.
- 2: Primary object, its related objects, and their related objects.
Data JSON array specifying the fields or criteria used to find duplicates. Typically includes properties like the timeline activity name or other identifying attributes.
Ids JSON array of IDs to limit the search scope to specific timeline activities. Can be used to target particular records when searching for duplicates.

Output

The output is a JSON structure containing the found duplicate timeline activities according to the input criteria. The exact structure depends on the API response but generally includes:

  • Details of each duplicate timeline activity found.
  • Nested related objects depending on the selected depth level.
  • Metadata about the duplicates such as counts or matching fields.

No binary data output is expected from this operation.

Dependencies

  • Requires an API key credential to authenticate with the Twenty API service.
  • The node uses the Twenty API base URL configured via credentials.
  • The operation sends HTTP requests with JSON bodies and expects JSON responses.

Troubleshooting

  • Invalid JSON in Data or Ids: Since these inputs expect JSON arrays, malformed JSON will cause errors. Ensure valid JSON formatting.
  • Authentication Errors: Missing or invalid API credentials will result in authorization failures. Verify that the API key credential is correctly set up.
  • Depth Parameter Misuse: Using unsupported depth values may lead to unexpected results or errors. Use only 0, 1, or 2.
  • Empty Results: If no duplicates are found, the output will be empty. Confirm that the input criteria (Data and Ids) correctly specify the timeline activities to check.

Links and References

Discussion