Habitica icon

Habitica

Habitica API

Overview

This node integrates with the Habitica API to add a checklist item to a specific task. It is useful for users who want to programmatically manage their Habitica tasks by adding detailed checklist items, which can help break down larger tasks into smaller actionable steps. For example, a user could automate adding daily subtasks or reminders within a task to track progress more granularly.

Properties

Name Meaning
Task The target task to which the checklist item will be added. Can be selected from a list of tasks or specified by its unique ID (UUID format).
Checklist Item Text The text content of the checklist item that describes the subtask or step to add.
Completed A boolean indicating whether the new checklist item should be marked as completed upon creation (true or false).

Output

The node outputs JSON data representing the response from the Habitica API after adding the checklist item. This typically includes details about the updated task and its checklist items. The output does not include binary data.

Dependencies

  • Requires an API key credential for authenticating with the Habitica API.
  • The node uses the Habitica API base URL, which can be customized if using a self-hosted instance.
  • No additional external dependencies are required beyond the Habitica API access.

Troubleshooting

  • Invalid Task ID: If the provided task ID does not match the expected UUID format, the node will reject it. Ensure the task ID follows the pattern like "a1abf9df-d89d-4f5e-9e80-26dc3c481042".
  • Authentication Errors: Missing or invalid API credentials will cause authentication failures. Verify that the API key credential is correctly configured.
  • API Rate Limits: Habitica enforces rate limits; excessive requests may result in errors. Implement retries or delays if necessary.
  • Checklist Item Text Empty: Providing an empty string for the checklist item text might lead to API rejection or meaningless checklist entries. Always provide meaningful text.

Links and References

Discussion