Imobzi icon

Imobzi

Interagir com a API da Imobzi
Join our community

Actions62

Overview

This node integrates with the Imobzi API to manage tasks ("Tarefa" resource) among other resources. Specifically, the Update operation for the "Tarefa" resource allows users to update an existing task by specifying its ID and the fields to modify.

Typical use cases include:

  • Automating updates to task details such as title, description, date, or contact information.
  • Synchronizing task data from other systems into Imobzi.
  • Modifying task attributes dynamically based on workflow logic.

For example, you could update a task’s title and due date after receiving new information from another system or user input.

Properties

Name Meaning
Task Name or ID Select an existing task from a dropdown list or specify its ID via expression.
Update Fields Collection of fields to update on the task. Options include:
- Date The date associated with the task (string).
- Description A textual description of the task.
- Email Email address related to the task.
- Name Name associated with the task.
- Phone Phone number related to the task.
- Title Title of the task.
- Value Numeric value associated with the task.

Output

The node outputs JSON data representing the updated task object returned by the Imobzi API. The output structure corresponds to the API's response format for a task resource, typically including all task properties after the update.

No binary data is produced by this operation.

Example output snippet (conceptual):

{
  "id": 123,
  "title": "Updated Task Title",
  "description": "Updated description",
  "date": "2024-06-01",
  "email": "example@email.com",
  "phone": "1234567890",
  "value": 100
}

Dependencies

  • Requires an active connection to the Imobzi API.
  • Needs an API authentication token configured in n8n credentials (referred generically as "an API key credential").
  • The node uses the Imobzi REST API endpoints for tasks (/tasks).

Troubleshooting

  • Common issues:

    • Invalid or missing task ID: Ensure the task ID exists and is correctly specified.
    • Empty update fields: If no fields are provided to update, the API may reject the request or perform no changes.
    • Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
    • Network or API downtime: Check connectivity and Imobzi service status.

  • Error messages:

    • "Resource 'tarefa' not supported!": This indicates an internal mapping issue; ensure the resource is correctly selected.
    • "Operation 'update' not supported!": Indicates an unsupported operation was requested.
    • API error responses will be passed through; check the message for details like invalid fields or permission issues.

To resolve errors, verify inputs, credentials, and API availability.

Links and References

Discussion