Attio icon

Attio

Interact with Attio API

Actions56

Tasks → List Tasks

AI-generated

Overview

This node operation interacts with the Attio API to list tasks based on various filtering and pagination parameters. It is useful for retrieving a customized list of tasks from the Attio workspace, such as filtering by assignee, completion status, linked records, and sorting order. Practical examples include fetching the latest tasks assigned to a specific user or retrieving tasks linked to a particular record for project management or reporting purposes.

Use Case Examples

  1. List the first 10 tasks sorted by creation date descending.
  2. Retrieve tasks assigned to a specific workspace member by email or ID.
  3. Filter tasks to only those linked to a specific person record using linked_object and linked_record_id parameters.
  4. Get tasks that are completed or not completed based on the is_completed boolean filter.

Properties

Name Meaning
Limit The maximum number of task results to return, controlling pagination.
Offset The number of task results to skip before starting to return results, used for pagination.
Sort Sort order of the returned tasks, either oldest first (created_at:asc) or newest first (created_at:desc).
Linked Object Filter tasks to only those containing a linked record of the specified object type (e.g., people).
Linked Record Id Filter tasks to only those containing the specified linked record ID. Must be used with Linked Object.
Assignee Filter tasks by workspace member assignees, referenced by email or ID. Use empty or 'null' to find tasks with no assignee.
Is Completed Filter tasks by completion status: true for completed tasks, false for non-completed tasks, or both if unspecified.

Output

JSON

  • json - The JSON response from the Attio API containing the list of tasks matching the query parameters.

Dependencies

  • Attio API access with an API key credential

Troubleshooting

  • Common issues include invalid or missing API credentials, resulting in authorization errors.
  • Incorrect parameter values may cause the API to return errors or empty results, such as providing linked_record_id without linked_object.
  • Network connectivity issues can prevent successful API requests.
  • Error messages from the API will be returned in the node output if continueOnFail is enabled, otherwise they will cause the node to fail.

Links

Discussion