TwentyDEV icon

TwentyDEV

Consume the Twenty API

Actions252

Overview

This node allows you to retrieve detailed information about a single workflow by its unique identifier. It is useful when you need to fetch the configuration or metadata of a specific workflow within your automation environment. For example, you might use this node to inspect a workflow's settings before making updates or to verify its structure during debugging.

Properties

Name Meaning
Id The unique identifier of the workflow you want to find.
Depth Determines how much related nested data to include in the response:
- 0: Only the primary workflow object information.
- 1: The workflow plus its directly related objects (no further nesting).
- 2: The workflow, its directly related objects, and their related objects (two levels of nesting).

Output

The output JSON contains the detailed data of the requested workflow. Depending on the selected depth, it includes the workflow's core properties and optionally nested related objects such as linked executions, triggers, or other associated entities. This enables comprehensive inspection of the workflow's structure and relationships.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential to authenticate requests to the external service providing workflow data.
  • The node uses a base URL configured via credentials to connect to the API endpoint.
  • No additional external dependencies are required beyond the provided API access.

Troubleshooting

  • Invalid or missing Id: If the workflow ID is incorrect or not provided, the node will fail to find the workflow. Ensure the ID is accurate and non-empty.
  • Insufficient permissions: Authentication failures may occur if the API key lacks rights to read workflows. Verify that the API key has appropriate access.
  • Depth parameter misuse: Setting an unsupported depth value could lead to unexpected results or errors. Use only 0, 1, or 2 as specified.
  • Network issues: Connectivity problems with the API endpoint can cause request failures. Check network availability and API server status.

Links and References

Discussion