Workflow states
Workflows progress through different states during their lifecycle.Draft
Draft
Draft workflows can be edited and tested but will not execute automatically. Use draft state to build, refine, and test automation before activation.What you can do:
- Edit triggers and actions
- Add or remove workflow steps
- Test with manual triggers
- Validate workflow configuration
Published
Published
Published workflows are active and respond to triggers automatically. All executions are logged and tracked. You can edit published workflows, and changes take effect only after you publish again.
Paused
Paused
Paused workflows stop accepting new runs while allowing in-flight executions to complete. This provides a controlled way to temporarily halt workflow execution.When to use:
- Temporarily stop workflow activity during maintenance
- Allow running workflows to complete before making changes
- Gracefully wind down workflow execution
Deleted
Deleted
Deleted workflows are soft deleted, preserving historical records while removing them from active use. Execution history is preserved and can be restored by support if needed.
Publishing workflows
1
Complete workflow configuration
Ensure your workflow has a trigger and at least one action
2
Validate workflow
The system automatically checks for required fields, proper connections, and valid configurations
3
Fix validation errors
Address any highlighted issues before publishing
4
Click Publish
Confirm publication to activate your workflow
5
Verify activation
Check that the workflow appears in your active workflows list
You need appropriate permissions to publish workflows within a collection. Contact your workspace administrator if you cannot publish workflows.
Validation requirements
Before publishing, workflows are validated to ensure they will work correctly.Trigger validation
Trigger validation
Requirements:
- Exactly one trigger configured
- All required trigger fields completed
- Valid filters and conditions
- Proper channel or event selection
- Missing trigger configuration
- Invalid channel selection
- Incomplete filter conditions
Action validation
Action validation
Requirements:
- At least one action connected to trigger
- All required fields populated
- Valid dynamic references
- Proper integration permissions
- Missing required fields
- Invalid dynamic value references
- Disconnected integrations
Connection validation
Connection validation
Requirements:
- All actions connected to trigger or previous actions
- No orphaned steps
- No circular dependencies
- Valid execution flow
- Disconnected actions
- Circular references between steps
- Invalid execution order
Integration validation
Integration validation
Requirements:
- All referenced integrations connected
- Valid authentication credentials
- Proper API permissions
- Active integration status
- Disconnected integrations
- Expired credentials
- Insufficient API permissions
Updating published workflows
Edit published workflows without stopping them. A banner appears at the top of the editor showing “This workflow has unpublished changes” with publish and discard options. The banner persists until you publish or discard.When you are ready to apply your changes, choose a publish method:To abandon your edits, click Discard changes to revert to the last published version. All unpublished edits are removed. This cannot be undone.
The system shows how many active runs will be stopped when using “Stop & Publish” to help you make an informed decision.
Unpublishing workflows
Unpublish workflows to stop them from responding to triggers.1
Click unpublish
Click the Unpublish button on a published workflow
2
Choose unpublish method
Select how to handle existing runs:Pause: Running workflows continue until completion, but new runs are blocked. The workflow can be republished to resume. Recommended for most situations.Deactivate: All running workflows are stopped immediately, new runs are blocked, and the workflow returns to draft state. Use only when an immediate stop is required.
3
Confirm unpublish
The dialog shows how many active runs will be affected. Review and confirm your choice.
Tips
- Test before publishing. Test workflows in draft state with manual triggers and realistic data. Monitor the first few executions closely after publishing.
- Use “Publish” by default. Letting running workflows complete with the old version while new runs use the updated version is safer than stopping everything. Only use “Stop & Publish” for critical bug fixes.
- Start with limited scope. Begin with workflows that affect a small subset of tickets or users. Expand scope after verifying reliable operation.
- Coordinate with your team. Communicate with stakeholders before publishing workflows that affect shared processes.
- Add descriptions. Explain the workflow’s purpose and any recent changes in the description. This helps team members understand updates and troubleshoot issues.
Learn more about building workflows and monitoring workflows