Tallyfy icon

Tallyfy

Interact with Tallyfy workflow automation platform

Overview

This node integrates with the Tallyfy workflow automation platform, allowing users to interact with various Tallyfy resources such as blueprints, processes, tasks, and more. Specifically, for the Blueprint - Get operation, the node retrieves detailed information about a single blueprint (process template) identified by its unique ID.

Typical use cases include:

  • Fetching blueprint details to display or process within an automation workflow.
  • Using blueprint data to trigger further actions or decisions in a workflow.
  • Integrating Tallyfy blueprint metadata into other systems or reports.

For example, you might use this node to get the configuration of a specific blueprint before launching a new process based on it or to verify blueprint properties during an audit.

Properties

Name Meaning
Blueprint ID The unique identifier of the blueprint to retrieve. This is required to specify which blueprint's details to fetch.

Output

The output is a JSON object representing the blueprint's data as returned by the Tallyfy API. It typically includes all relevant blueprint properties such as title, type, status, creation date, and any other metadata associated with the blueprint.

The output structure corresponds directly to the API response for a single blueprint resource. Each item from the input results in one output item containing the blueprint data under the json key.

No binary data is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Tallyfy API.
  • The node uses the base URL https://go.tallyfy.com/api by default but can be configured via credentials.
  • Requires the organization ID to construct API endpoints; this is provided through the credentials.

Troubleshooting

  • Missing or invalid Blueprint ID: Ensure that the "Blueprint ID" property is set and valid. An incorrect or empty ID will cause the API request to fail.
  • Authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions to access blueprint data.
  • Network or API errors: Check network connectivity and Tallyfy service status if requests time out or return errors.
  • API rate limits: If many requests are made in a short period, the API may throttle calls. Implement retries or reduce request frequency.

Common error messages may include HTTP 401 Unauthorized (invalid credentials), 404 Not Found (invalid blueprint ID), or 500 Internal Server Error (server issues). Resolving these involves checking credentials, verifying IDs, and retrying later respectively.

Links and References

Discussion