Reclaim.ai Task icon

Reclaim.ai Task

Interact with Reclaim.ai tasks

Actions7

Create

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 options, updating existing tasks, deleting tasks, fetching single or multiple tasks, 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 task status programmatically.

Use Case Examples

  1. Create a new task with a specific title, priority, time schedule, and due date.
  2. Update an existing task's notes and priority.
  3. Delete a task by its ID.
  4. Retrieve all tasks filtered by status such as 'New' or 'Complete'. Mark a task as done or to-do based on workflow conditions. Start or stop a task's timer programmatically.

Properties

Name Meaning
Title Title of the task, required for creating a task.
Notes Additional notes or description for the task, optional for create and update operations.
Priority Priority level of the task, with options Urgent (P1), High (P2), Medium (P3), and Low (P4). Required for create and update operations.
Time Schedule The schedule associated with the task, required for creating a task. Loaded dynamically from Reclaim.ai schedules.
Event Category Category of the task, either Work or Personal, required for creating a task.
Due Date (UTC Time) The due date and time for the task in ISO 8601 format, optional for create and update.
Snooze Until (UTC Time) Date and time until which the task is snoozed, in ISO 8601 format, optional for create and update.
Duration (in minutes) Total time required for the task in minutes, in 15-minute increments, required for create and update.
Minimum Chunk Size (in minutes) Minimum duration of task sessions in minutes, in 15-minute increments, required for create and update.
Maximum Chunk Size (in minutes) Maximum duration of task sessions in minutes, in 15-minute increments, required for create and update.
Always Private Boolean flag indicating if the task should always be private, required for create and update.
Up Next Boolean flag indicating if the task should be marked as 'Up Next', required for create and update.
Event Color Color for the event, specified as a hex code or color name, optional for create and update.

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 create, get, update operations).
  • notes - Notes associated with the task.
  • priority - Priority level of the task.
  • timeSchemeId - ID of the time schedule associated with the task.
  • due - Due date of the task in ISO 8601 format.
  • snoozeUntil - Snooze until date in ISO 8601 format.
  • timeChunksRequired - Number of 15-minute chunks required for the task duration.
  • minChunkSize - Minimum chunk size in 15-minute increments.
  • maxChunkSize - Maximum chunk size in 15-minute increments.
  • alwaysPrivate - Boolean indicating if the task is always private.
  • onDeck - Boolean indicating if the task is marked as Up Next.
  • eventCategory - Category of the task (Work or Personal).
  • eventColor - Color assigned to the event.

Dependencies

  • Reclaim.ai API key credential

Troubleshooting

  • Ensure the API key credential for Reclaim.ai is correctly configured and has necessary permissions.
  • Validate that required fields like Title and Time Schedule are provided when creating a task.
  • Check date fields (Due Date, Snooze Until) are in valid ISO 8601 format to avoid errors.
  • For update operations, at least one field must be provided to update; otherwise, an error is thrown.
  • Handle API response errors gracefully; unexpected response formats may indicate API changes or issues.
  • When marking tasks or starting/stopping tasks, ensure the task ID and action parameters are valid and correctly set.

Links

Discussion