Basecamp icon

Basecamp

Interact with Basecamp API

Actions119

Todolist → Get to-Do Lists

AI-generated

Overview

This node operation retrieves to-do lists from a specified project (bucket) and to-do set within the Basecamp API. It allows filtering the to-do lists by their status (e.g., archived) and supports pagination to return all results or a limited number. This operation is useful for users who want to programmatically access and manage to-do lists within their Basecamp projects, such as fetching all active or archived to-do lists for reporting or automation purposes.

Use Case Examples

  1. Fetch all archived to-do lists from a specific project and to-do set for review.
  2. Retrieve active to-do lists to display in a custom dashboard or integration.

Properties

Name Meaning
Project ID The ID of the project (bucket) used in the API endpoint path to specify which project to retrieve to-do lists from.
To-Do Set ID The ID of the to-do set used in the API endpoint path to specify which to-do set within the project to retrieve lists from.
Status Filter to-do lists by their status, such as 'archived' or other statuses supported by the API.
Return All Results Boolean flag to determine whether to return all results by paginating through all pages or only up to a given limit.
Return Full Response Boolean flag to decide whether to return the full HTTP response including status code, headers, and body, or just the response body.

Output

JSON

  • body - The main content of the response containing the to-do lists data retrieved from the API.
  • statusCode - The HTTP status code of the API response, available if full response is requested.
  • headers - The HTTP headers of the API response, available if full response is requested.

Dependencies

  • Basecamp API with OAuth2 authentication

Troubleshooting

  • Ensure the Project ID and To-Do Set ID are correct and exist in the Basecamp account to avoid 404 errors.
  • If filtering by status returns no results, verify the status value is valid and that to-do lists with that status exist.
  • Pagination issues may occur if 'Return All Results' is set incorrectly; adjust this setting based on expected data volume.
  • If the node returns authentication errors, check that the OAuth2 credentials are valid and have the necessary permissions.

Discussion