Workspace Agent Tasks Node

Execute a workspace flow with the same container lifecycle behavior as Workspace Agent, but require the child flow to call a complete_task(...) tool before the run is considered complete.

This node injects a task-specific model context into the workspace flow input. The child flow can call:

complete_task(success: boolean, result_summary: string, artifact_id?: string)

The node can optionally reprompt the child flow if it finishes without calling the tool, require a valid artifact id on successful completion, and send success or failure notifications using the artifact notification pipeline.

Properties

Label	Property	Type	Description	Default Value	Is Required
Workspace	workspace	botdojo/types/workspace_reference	Workspace whose flow should be executed.	null
External Session ID	external_session_id	botdojo/types/string	Optional external session identifier for the workspace flow.	null	✅
Use Default Properties	useDefaultProperties	botdojo/types/boolean	If true, use the target flow's default property values.	false	✅
Reprompt Message	task_reprompt_message	botdojo/types/string	Follow-up message sent once if the child flow never calls complete_task(...).	null
Artifact Required	task_artifact_required	botdojo/types/boolean	Require complete_task(success: true, artifact_id: ...) to include a valid artifact id.	false	✅
Success Notify Enabled	task_notify_enabled	botdojo/types/boolean	Enable success notification delivery after a completed task.	false	✅
Success Notify To	task_notify_to	botdojo/types/array/string	Primary success notification recipients.	[]
Success Notify Cc	task_notify_cc	botdojo/types/array/string	Success notification CC recipients.	[]
Success Notify Bcc	task_notify_bcc	botdojo/types/array/string	Success notification BCC recipients.	[]
Success Subject Template	task_notify_subject	botdojo/types/string	Handlebars template rendered for success email subject.	default template
Success Body Template	task_notify_body	botdojo/types/string	Handlebars template rendered for success email body. Supports TEXT, HTML, or MARKDOWN.	default template
Success Body Format	task_notify_body_format	botdojo/types/string	Format used for the success body template.	MARKDOWN	✅
Attach Artifact	task_notify_attach	botdojo/types/boolean	Attach the completed artifact to the success email when available.	false	✅
Failure Notify Enabled	task_failure_notify_enabled	botdojo/types/boolean	Enable failure notification delivery.	false	✅
Suppress Main Recipients On Failure	task_failure_notify_suppress_main	botdojo/types/boolean	If true, failure notifications skip the main success recipients.	false	✅
Failure Notify To	task_failure_notify_to	botdojo/types/array/string	Primary failure notification recipients.	[]
Failure Notify Cc	task_failure_notify_cc	botdojo/types/array/string	Failure notification CC recipients.	[]
Failure Notify Bcc	task_failure_notify_bcc	botdojo/types/array/string	Failure notification BCC recipients.	[]
Failure Subject Template	task_failure_notify_subject	botdojo/types/string	Handlebars template rendered for failure email subject.	default template
Failure Body Template	task_failure_notify_body	botdojo/types/string	Handlebars template rendered for failure email body.	default template
Failure Body Format	task_failure_notify_body_format	botdojo/types/string	Format used for the failure body template.	MARKDOWN	✅
Attach Artifact On Failure	task_failure_notify_attach	botdojo/types/boolean	Attach the artifact referenced by complete_task(...) to the failure email when present.	false	✅

Output

Label	Property	Type	Description	Default Value
Output	output	botdojo/types/data	Output returned from the workspace flow.	null

Template Variables

Success and failure notification templates receive:

• success
• result_summary
• artifact_id
• artifact_link
• link
• session_id
• output

Failure templates also receive the task failure reason when the child flow fails to call complete_task(...) or returns invalid task completion data.