Autotask icon

Autotask

Consume Autotask REST API
Join our community

Actions389

Overview

This node operation retrieves detailed information about a specific task within a project in Autotask. It is useful for scenarios where you need to fetch the current state, attributes, or metadata of a project task by specifying its project and task IDs. For example, you might use it to display task details in a dashboard, verify task status before updates, or integrate task data into other workflows.

Properties

Name Meaning
Project ID The unique identifier of the project to which the task belongs, used to scope the task retrieval.
Task ID The unique identifier of the task to retrieve details for.
Add Picklist Labels Determines whether to add human-readable label fields for picklist-type fields in the task data, enhancing readability.
Add Reference Labels Determines whether to add human-readable label fields for reference-type fields in the task data.
Select Columns Names or IDs. Specifies which fields of the task to include in the response. If none are selected, all fields are returned. The task ID is always included.
Flatten User-Defined Fields If enabled, user-defined fields (UDFs) are moved to the top level of the returned object instead of being nested, simplifying access.

Output

JSON

  • id - The unique identifier of the retrieved task.
  • projectID - The ID of the project the task belongs to.
  • name - The name or title of the task.
  • status - Current status of the task.
  • startDate - The start date of the task.
  • dueDate - The due date of the task.
  • assignedResourceID - ID of the resource assigned to the task.
  • assignedResourceID_label - Human-readable label of the assigned resource, if Add Reference Labels is enabled.
  • priority - Priority level of the task.
  • priority_label - Human-readable label of the priority, if Add Picklist Labels is enabled.
    userDefinedFields - Individual user-defined fields as top-level properties if flattenUdfs is enabled.

Dependencies

  • Autotask REST API
  • API authentication credentials

Troubleshooting

  • Ensure that both Project ID and Task ID are correctly specified and exist in Autotask; otherwise, the node will return an error indicating the task was not found.
  • If the node returns incomplete data, verify that the 'Select Columns' property includes the desired fields or leave it empty to retrieve all fields.
  • If human-readable labels are missing, check that 'Add Picklist Labels' and 'Add Reference Labels' are enabled and that the referenced data exists.
  • Authentication errors indicate issues with the provided API credentials; verify and update credentials as needed.

Discussion