Basecamp icon

Basecamp

Interact with Basecamp API

Actions119

Todolist Group → List to-Do List Groups

AI-generated

Overview

This node operation retrieves a list of to-do list groups within a specified to-do list and project (bucket) in Basecamp. It is useful for users who want to organize and manage groups of to-do lists under a project, allowing them to filter groups by status and control the amount of data returned.

Use Case Examples

  1. A project manager wants to fetch all active to-do list groups within a specific project to review progress.
  2. A team lead needs to archive completed to-do list groups and wants to list only archived groups for cleanup.

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 list groups from.
To-Do List ID The ID of the to-do list used in the API endpoint path to specify which to-do list's groups to retrieve.
Status Filter to-do list groups by their status, such as 'archived' or active groups.
Return All Results Whether to return all results or only up to a given limit, supporting pagination.
Return Full Response Whether to return the full HTTP response including status code, headers, and body instead of only the response body.

Output

JSON

  • response
    • statusCode - HTTP status code of the API response.
    • headers - HTTP headers returned by the API.
    • body - The body of the API response containing the list of to-do list groups.

Dependencies

  • Basecamp API with OAuth2 authentication

Troubleshooting

  • Ensure the Project ID and To-Do List ID are correct and exist in the Basecamp account to avoid 404 errors.
  • If filtering by status, verify the status value is valid (e.g., 'archived').
  • Check API rate limits and pagination settings if not all results are returned.
  • If 'Return Full Response' is enabled, handle the full response object correctly in downstream nodes.

Discussion