A complete guide to understanding, managing, and completing tasks in Torii. Tasks help coordinate approvals, collect information, and keep workflows moving seamlessly.

What is a Task in Torii?

In Torii, a task represents an action item assigned to a user as part of an operational process, typically within an automated workflow. Tasks ensure the right people complete the right steps at the right time, whether it's reviewing an access request or filling in application details.

Each task contains key metadata that helps track its lifecycle, responsibility, and context.

Task Properties

• Task ID

  A unique identifier for each task, formatted as T-<number> (e.g., T-123). Task IDs are generated sequentially and are useful for referencing tasks in audits, communications, and reporting.

• Creation Time

  The timestamp when the task was generated, either manually or via automation.

• Created By

  Indicates who created the task, either a specific user or an automated workflow.

• Assignee

  The user responsible for completing the task. Assignees receive notifications and can track the task status in their Torii workspace.

• Status

  The current state of the task. Possible values include:

  • Open: The task is awaiting completion.
  • Completed: The task was successfully completed.
  • Canceled: The task was terminated (e.g., due to a workflow being stopped).

• Type

  Defines the nature of the task. Current types include:

  • Approval request
  • Fill application form
  • Fill contract form

Creating Tasks

Currently, tasks in Torii are automatically created as part of a workflow. There is no manual task creation outside the workflow builder.

How to Create a Task via Workflow

To create a task, you must use one of the following workflow actions when building or editing a workflow:

1. Create Task – Approval Request

   Use this action when you need someone to review and approve an access request, application change, or any other decision.

2. Create Task – Fill Application Form

   This action generates a task requiring the assignee to complete an application-related form, such as entering missing information.

3. Create Task – Fill Contract Form

   Use this to assign a task that prompts the assignee to fill in contract-related information, typically as part of procurement or vendor management.

Each of these actions can be configured with custom instructions, assign a specific user, and be triggered based on defined conditions (e.g., a new app being onboarded, a contract nearing renewal, or a license threshold being exceeded).

Understanding the Relationship Between Tasks and Workflows

Tasks in Torii are tightly integrated with workflows and play a critical role in controlling workflow execution. Each time a workflow reaches a “Create task” action, it pauses execution and waits for the assigned user to complete the task before proceeding.

How Tasks Control Workflow Progress

• When a workflow execution hits a Create Task action (e.g., approval request or form completion), the workflow enters an "In Progress" state.
• During this period, the workflow is effectively paused, it cannot continue until the task is completed by the assigned user.
• Once the task is marked as Completed, the workflow resumes and moves on to the next step in the automation sequence.

This mechanism ensures that human input or validation is obtained precisely when needed, without losing automation continuity.

What Happens If a Workflow is Stopped?

If a running workflow is manually stopped, any open tasks that were generated by that workflow and are still waiting to be completed will be automatically canceled. This prevents orphaned tasks from lingering and ensures that users aren't left with unnecessary or invalid action items.

Viewing Tasks

Tasks in Torii are currently visible only to Torii admins, providing a centralized view of all task-related activity. This allows administrators to track progress, follow up with assignees, and manage workflows more effectively.

Navigating to the Tasks Page

To access the task list:

• Open the Torii admin console
• Click on "Tasks" from the left-hand navigation pane

This will take you to the main Tasks page, where all tasks, regardless of their type or origin, are visible.

The Three Task Tabs

The Tasks page is organized into three tabs:

1. Open – Displays all active tasks that are still pending action from their assignees.
2. Completed – Shows tasks that have been successfully finished.
3. Canceled – Lists tasks that were canceled, typically due to a workflow being stopped.

Each tab provides insights into task history and status, making it easy to monitor task lifecycle and identify bottlenecks.

Filtering and Searching

Admins can:

• Search for tasks using keywords
• Filter tasks by attributes such as assignee, type, status, and creation date

This helps quickly locate specific tasks or narrow down the view to a subset of interest.

Task Settings

From the Tasks page, admins can also access the Task Settings by clicking the dedicated button. This section allows configuration of global task-related settings, including notification preferences (which we’ll cover in a later section).

Receiving Tasks

When a task is assigned to a user in Torii, they are notified automatically so they can take action promptly. Notifications can be sent via Slack, email, or both, depending on the organization's configuration.

Notification Methods

Torii admins can configure how task notifications are delivered in the Task Settings page. Notifications can be toggled on or off for:

• Email notifications
• Slack notifications

Admins must also select the appropriate Slack workspace for task delivery.

You’ll find the Task Settings section linked directly from the Tasks page for easy access.

Slack Notifications

When enabled, assignees receive a direct Slack message that includes:

• The task type (e.g., Approval request)
• The task question or instruction
• Action buttons (e.g., Approve / Decline for approval tasks)

The user can complete the task directly from Slack without needing to open Torii.

Email Notifications

Similarly, email notifications include:

• The assignee's name
• A task prompt with the required question or action
• Action buttons (e.g., Approve / Decline)

Just like Slack, users can complete the task directly from the email.

Completing Tasks

Tasks in Torii are designed to be easy for assignees to complete, with minimal friction. Based on the task type, users are presented with clear options to either take immediate action (via Slack/email) or complete a short form on the web.

Approval Request Tasks

Approval tasks ask a user to make a decision, such as approving or rejecting access. These tasks include two action buttons in the notification.

• Assignees can complete the task directly from Slack or email
• No need to log into Torii—just click a button to respond

Customizable Button Labels

When creating an approval task in the workflow builder, admins can customize the button labels to match the context of the request.

Examples:

• Default: Approve / Decline
• Custom: Yes / No, Confirm / Reject, etc.

This allows for more natural language and better alignment with the intent of the workflow.

You’ll find the button label fields when setting up the Create Task – Approval Request action in a workflow.

Slack example:

Email example:

Fill Application Form / Fill Contract Form Tasks

These tasks require users to fill out a short web form, typically used to collect information related to an app or contract.

Assignees are notified via:

• Slack: with a message and an "Answer Form" button
• Email: with the same message and an "Answer Form" button

Clicking the button in either channel opens a Torii-hosted web page where users can complete the form.

Title and Message Customization

Every task created through a workflow includes:

• A Title – shown in the email subject and Slack message header
• A Message – used as the message body in both Slack and email

This allows admins to personalize tasks using relevant context (e.g., “Please fill in contract details for Hubspot”).

Slack format:

<Title>: <Message>

Email format:

• Subject: New task – <Title>
• Body: <Message> followed by the action button

Example:

Title: Fill application form

Message: I'd be happy if you could fill out a few details about it.

Canceling Tasks (Stopping a Workflow)

In Torii, tasks are not canceled manually or individually. Instead, cancellation occurs automatically when the parent workflow is stopped.

When Are Tasks Canceled?

If a workflow that is currently running reaches a task creation step (e.g., approval or form task), it pauses and waits for the task to be completed. However, if an admin decides to stop the workflow before the task is completed, Torii will:

• Cancel any open tasks that the workflow is waiting on
• Mark those tasks with a "Canceled" status in the Tasks page

This ensures workflows don’t hang indefinitely and keeps the task list clean of unresolved or obsolete tasks.

Notification Settings

Torii provides flexible notification options so that task assignees are immediately alerted when they are assigned a new task. These settings are configurable by Torii admins and can be adjusted to match your team’s communication preferences.

Accessing Notification Settings

To configure how task assignees are notified:

1. Navigate to the Tasks page using the left-hand navigation pane.
2. Click the “Task Settings” link from the top-right of the page.
3. Under the Notifications section, you’ll find options to control delivery channels.

Available Notification Channels

• Email Notifications

  When enabled, assignees receive a structured email showing the task title, message, and relevant action button(s).

• Slack Notifications

  When enabled, Torii sends a direct Slack message to the assignee’s Slack account, including the task context and action buttons.

Each method presents the task in a user-friendly format:

• Approval request: Includes "Approve" and "Decline" buttons
• Form tasks: Includes an "Answer Form" button that links to a Torii-hosted form

You can enable one or both channels depending on what works best for your organization.

Task Types in Torii

When adding a task to a workflow, admins choose from a set of predefined task types, each designed for a specific type of action. These types determine what the assignee will be asked to do and how they’ll interact with the task.

In the workflow builder, each task action is clearly labeled with its purpose and includes a short description:

Available Task Types

1. Create task – Approval Request

   Description: Asks the assignee to approve or deny access

   Use case: Common for app access requests or decision-based workflows.

   Interaction: Assignee chooses Approve or Decline directly from the Slack or email message.

2. Create task – Fill Application Form

   Description: Asks the assignee to fill a customizable application form

   Use case: Collect metadata, compliance details, or missing information for a SaaS application.

   Interaction: Assignee clicks Answer Form to open and complete the form on a web page.

3. Create task – Fill Contract Form

   Description: Asks the assignee to fill a customizable contract form

   Use case: Collect contractual information from stakeholders as part of procurement or renewal workflows.

   Interaction: Similar to application forms, completed via a linked form from Slack or email.

These options ensure you can build workflows that involve people when needed, without sacrificing automation.