Actions54
- Blueprint Actions
- Process Actions
- Task Actions
- Form Field Actions
- Comment Actions
- User Actions
- Guest Actions
- Group Actions
- Search Actions
- ID Finder Actions
Overview
This node operation allows you to mark a specific task as completed within the Tallyfy workflow automation platform. It is useful in scenarios where you want to programmatically update the status of tasks once they are done, optionally adding comments or other metadata at completion time.
Practical examples include:
- Automatically completing tasks after an external event occurs (e.g., a file upload or form submission).
- Adding a comment when completing a task to provide context or notes.
- Triggering webhooks or notifications upon task completion by specifying webhook URLs.
Properties
| Name | Meaning |
|---|---|
| Task ID | The unique identifier of the task to be completed. |
| Additional Fields | Optional extra fields to set when completing the task: |
| - Summary | A brief summary description of the task. |
| - Assign Users | Comma-separated list of user IDs to assign to the task. |
| - Assign Guests | Comma-separated list of guest emails to assign to the task. |
| - Assign Groups | Comma-separated list of group IDs to assign to the task. |
| - Start Date | The date and time when the task should start. |
| - Everyone Must Complete | Boolean flag indicating if all assignees must complete the task. |
| - Comment | A comment to add when completing the task. |
| - Webhook URL | A webhook URL to call on task events. |
| - Tags | Comma-separated list of tag IDs to associate with the task. |
Output
The output JSON contains the response from the Tallyfy API after completing the task. This typically includes details about the completed task such as its ID, status, timestamps, and any updated properties.
No binary data is output 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/apior a custom base URL if specified in credentials. - Requires the organization ID to construct API endpoints.
Troubleshooting
- Invalid Task ID: If the provided Task ID does not exist or is incorrect, the API will return an error. Verify the Task ID before running the node.
- Authentication Errors: Ensure that the API key credential is valid and has sufficient permissions to complete tasks.
- Missing Required Fields: The Task ID is mandatory; omitting it will cause the node to fail.
- API Rate Limits: If many tasks are completed in rapid succession, you may hit API rate limits. Implement retries or delays as needed.
- Malformed Additional Fields: When providing comma-separated lists (e.g., assignUsers), ensure no trailing commas or invalid formats.
Links and References
- Tallyfy API Documentation (general reference for API endpoints)
- Tallyfy Workflow Automation Platform