TwentyDEV icon

TwentyDEV

Consume the Twenty API

Actions252

Overview

This node operation allows creating multiple workflow versions in bulk. It is useful when you need to programmatically generate several versions of a workflow, for example during automated deployment pipelines, version management, or batch updates of workflows in an environment.

Practical examples include:

  • Creating draft versions of workflows with specific names before publishing.
  • Automating the creation of multiple workflow versions with different configurations or statuses.
  • Managing workflow lifecycle by generating versions in bulk for testing or staging environments.

Properties

Name Meaning
Depth Determines how much nested related data to include in the response:
- 0: Only primary workflow version information.
- 1: Primary object plus directly related objects.
- 2: Includes related objects of related objects as well.
Body JSON object representing the workflow version(s) to create. Typically includes fields like status (e.g., "DRAFT") and name (the workflow version name). This property accepts raw JSON input describing the workflow version details.

Output

The node outputs JSON data representing the created workflow versions. The structure corresponds to the API response and includes the newly created workflow version objects along with any requested nested related objects depending on the Depth parameter.

No binary data output is indicated.

Dependencies

  • Requires an API key credential to authenticate requests against the Twenty API service.
  • The base URL for the API is configured via credentials.
  • The node uses the Twenty API OpenAPI specification internally to build requests.

Troubleshooting

  • Invalid JSON in Body: If the JSON provided in the Body property is malformed, the node will fail. Ensure valid JSON syntax.
  • Authentication Errors: Missing or invalid API credentials will cause authentication failures. Verify that the API key credential is correctly set up.
  • Invalid Depth Value: Using a depth value outside the allowed range (0, 1, 2) may result in errors or unexpected responses.
  • API Rate Limits or Quotas: Bulk creation might hit API limits; monitor usage and handle rate limiting accordingly.

Links and References

Discussion