Skip to main content
Skip table of contents

Playbook Tasks

LAST UPDATED: MAR 3, 2025

Tasks are the building blocks of automation playbooks, driving workflows through predefined actions tailored to business requirements, data transformations, and decision logic. Where necessary, interactive elements may be integrated to provide enhanced flexibility and operational oversight.

For each playbook type, the most commonly used task types are immediately visible in the task menu, while additional task types are organized under the image 27 (3)-20250213-182224.png popover menu.

Frame 150 (5)-20250213-175647.png
Task Types and Sample Data

Playbook tasks serve different functions, some shared between preprocessing and investigation playbooks, others exclusive.

Preprocessing Playbooks Only

Both

Investigation Playbooks Only

VIEWING SAMPLE DATA

* Task types marked with an asterisk allow users to view sample input and output data formats.

Group 33.png

Sample Input Data for an Integration Command

Relationship Between Tasks with Triggers

Key Principles

  1. The mere existence of tasks in a playbook does not guarantee their execution.

  2. Executable tasks must be connected to an upstream trigger. Orphan nodes will not execute.

  3. Tasks downstream of a trigger can execute if and only if the trigger's activation condition is met.

    Frame 14.png
  4. Even when a trigger activates, some tasks may not execute to completion due to:

    • Conditional Logic – Branching control flow may exclude certain task paths.

    • Human Interaction – Tasks requiring user input or approval may pause flow progression.

    • External Dependencies – Commands involving API calls may be affected by configuration settings or rate limits.

Task Input Data

Static

Dynamic

Frame 244 (1)-20250213-204450.png

Static Input

Static inputs refer to input values that remain constant throughout execution, such as predefined parameters for commands or fixed configuration settings.

Static Input Examples

EXAMPLE: Ingestion Command Parameters

Group 34.png

EXAMPLE: Task Dropdown Fields

Group 32 (1).png
Group 35.png

Dynamic Input

Dynamic inputs refer to data whose values may vary based on context and task outcomes. See‎ Dynamically Selecting Data to learn more.

Task Output Data

After task execution, users can review task details by clicking on the status icon (typically Frame 3.png or Group 142.png).

Frame 9 (46)-20250213-211233.png
Output Types

Task outputs are categorized into key fields, context data, return data, raw data, result, and playbook data. While some categories may be absent depending on the command, return data is always present.


Key Fields: Meant to present pertinent command output values in a label-above-value format, minimizing nesting to one level, rarely two, as an alternative to raw code.

Group 73.png

Context Data: Meant to hold command-specific contextual data. May be identical to Raw Data in some cases.

Group 72.png

READER NOTE

D3 has discontinued the use of context data (CD) in all newly developed commands.

EXAMPLES

Integration: Gmail | Command: Send Email | CD: PRESENT

Integration: Gmail V2 | Command: Send Email | CD: ABSENT

Integration: ServiceNow | Command: Get SysID | CD: PRESENT

Integration: ServiceNow v2 | Command: Get Sys ID | CD: ABSENT

Integration: Splunk | Command: Get Application List | CD: PRESENT

Integration: Splunk v2 | Command: Get Application List | CD: ABSENT

Integration: Splunk | Command: Check IP Reputation | CD: PRESENT

Integration: Splunk v3 | Command: Check IP Reputation | CD: ABSENT

Return Data: Indicates whether the task executed successfully, partially successfully, or failed.

Group 74.png

READER NOTE

In check reputation commands, return data converts raw risk scores into D3-defined risk levels and names, enriching artifacts with reputation details.

Raw Data: The majority, if not all, of the pertinent API response data.

Group 75.png

Result: A brief summary of API response data presented in a structured HTML table.

Frame 245-20250214-023424.png

Playbook Data: The cumulative set of information that flowed through this playbook, extending up to and including that of the current task node.

Frame 246-20250214-024506.png

Troubleshooting a Playbook Task

A playbook task may fail due to invalid inputs, insufficient permissions, missing parameters, or other factors. Users can view error explanations by clicking on the Group 142.png status icon.

Group 78.png

Working Version Playbooks

Test-ran playbooks allow users to diagnose errors by reviewing error messages and making immediate adjustments.

Frame 256 (1)-20250214-191947.png
Examples

EXAMPLE 1: Jinja Syntax Error

Frame 248-20250214-175102.png

Discovering the Error

Frame 249-20250214-180701.png

Fixing the Error

Frame 251-20250214-181216.png

Verifying Error Resolution

EXAMPLE 2: Connection and Quota

Frame 252-20250214-182307.png

Discovering Missing Connection

Frame 253 (2)-20250214-185334.png

Adding a Valid Connection

READER NOTE

Refer to the relevant integration document for steps to configure the connection.

Frame 254-20250214-185634.png

Discovering Additional Error(s)

Frame 255-20250214-185821.png

Discovering Quota Exceeded Error

READER NOTE

  • A 429 Too Many Requests error means the API rate limit has been reached.

  • Check API limits and request an increase as required.

Live Version Playbooks

All preprocessing and investigation playbook errors are tracked in the investigation dashboard.

Frame 257-20250214-192531.png
Examining and Resolving an Error

SCENARIO: A task fails because it references the Phishing playbook, which has not been made available for the demo-site.

  1. Click into an error from the dashboard.

  2. Click on a task displaying Group 142.png.

    Frame 258-20250214-193413.png
  3. Review and comprehend the error message.

    Frame 260-20250214-194206.png
  4. Open the Phishing playbook using an account with edit permissions).

    Frame 259-20250214-194129.png
  5. Click on the Publish button.

    Frame 261-20250214-195114.png
  6. Locate and add the relevant site (demo-site).

    Frame 262-20250214-195050.png
  7. Re-run the error task from step 3 with the required parameters.

    Frame 263-20250214-195746.png
  8. Verify task completion.

    Frame 264-20250214-195936.png

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.