Reclaim.ai Task icon

Reclaim.ai Task

Interact with Reclaim.ai tasks

Actions7

Update

AI-generated

Overview

This node interacts with Reclaim.ai tasks, allowing users to create, update, delete, retrieve, and manage tasks within the Reclaim.ai platform. It supports operations such as creating new tasks with detailed scheduling and priority settings, updating existing tasks with optional fields, deleting tasks by ID, retrieving single or multiple tasks with status filtering, marking tasks as done or to-do, and starting or stopping tasks. This node is useful for automating task management workflows, integrating task scheduling with other systems, and maintaining up-to-date task statuses programmatically.

Use Case Examples

  1. Automatically create a new task in Reclaim.ai when a new project is initiated, specifying title, priority, duration, and schedule.
  2. Update an existing task's title, notes, priority, and due date based on changes in a project management tool.
  3. Retrieve all tasks with specific statuses to generate reports or dashboards.
  4. Mark a task as done when a related process completes in another system.

Properties

Name Meaning
Task ID The unique identifier of the task to operate on (required for get, update, delete, markTaskAs, startStopTask operations).
Title (Optional) The title of the task, used only when updating a task.
Notes Additional notes or description for the task, applicable when creating or updating.
Priority The priority level of the task, with options Urgent (P1), High (P2), Medium (P3), and Low (P4).
Due Date (UTC Time) The due date and time for the task in ISO 8601 format (UTC).
Snooze Until (UTC Time) Date and time until which the task is snoozed, in ISO 8601 format (UTC).
Duration (in minutes) The total time required for the task, in 15-minute increments (minimum 15 minutes).
Minimum Chunk Size (in minutes) Minimum duration of task sessions in 15-minute increments (minimum 15 minutes).
Maximum Chunk Size (in minutes) Maximum duration of task sessions in 15-minute increments (minimum 15 minutes).
Always Private Boolean flag indicating whether the task should always be private.
Up Next Boolean flag indicating whether the task should be marked as "Up Next" for prioritization.
Event Color Color code or name for the event associated with the task (e.g., #FF0000 or "blue").

Output

JSON

  • success - Indicates if the operation was successful (true/false).
  • id - The ID of the task involved in the operation.
  • action - The action performed on the task, such as marking as done or starting/stopping.
  • response - Raw response data from the Reclaim.ai API for the operation.
  • title - Title of the task (for get, getAll, create, update operations).
  • notes - Notes associated with the task.
  • priority - Priority level of the task.
  • due - Due date of the task in ISO 8601 format.
  • snoozeUntil - Snooze until date in ISO 8601 format.
  • duration - Duration of the task in minutes.
  • minChunkSize - Minimum chunk size for task sessions in minutes.
  • maxChunkSize - Maximum chunk size for task sessions in minutes.
  • alwaysPrivate - Boolean indicating if the task is always private.
  • onDeck - Boolean indicating if the task is marked as Up Next.
  • eventColor - Color associated with the task event.

Dependencies

  • Reclaim.ai API

Troubleshooting

  • Ensure the Task ID is provided for operations that require it (get, update, delete, markTaskAs, startStopTask) to avoid errors.
  • Validate date fields (Due Date, Snooze Until) are in correct ISO 8601 format to prevent invalid date errors.
  • For update operations, provide at least one field to update; otherwise, an error is thrown.
  • Check API key credentials are correctly configured and valid to avoid authentication errors.
  • Unexpected API responses may occur; review logs for warnings and verify API status if issues arise.

Links

Discussion