Whoz icon

Whoz

Interact with Whoz talent management platform
Join our community

Actions25

Overview

This node integrates with the Whoz talent management platform to perform operations on various resources, including tasks. Specifically, for the Task resource and the Delete operation, it allows users to delete a task by specifying its unique Task ID. This is useful in scenarios where you need to programmatically remove obsolete or completed tasks from the Whoz system as part of an automated workflow.

Practical examples:

  • Automatically deleting tasks that are marked as completed in another system.
  • Cleaning up tasks related to a project once the project is archived.
  • Removing test or placeholder tasks created during data import processes.

Properties

Name Meaning
Task ID The unique ID of the task to be deleted

Output

The output JSON contains information about the success of the deletion operation and the ID of the deleted task. It typically looks like this:

{
  "success": true,
  "id": "the-task-id",
  // ...additional response data from the API if any
}

This confirms that the task was successfully deleted. No binary data is output by this node.

Dependencies

  • Requires an active connection to the Whoz talent management platform via an OAuth2 API credential.
  • The node uses the Whoz API endpoint, which varies depending on the environment (sandbox or production).
  • Proper API permissions are needed to delete tasks.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent Task ID will result in an error.
    • Insufficient API permissions can cause authorization errors.
    • Network or connectivity issues may prevent the API call from succeeding.

  • Error messages and resolutions:

    • "Unknown error" — General fallback error; check network and API credentials.
    • API-specific errors returned by Whoz (e.g., 404 Not Found) indicate the Task ID does not exist; verify the ID.
    • Authentication errors suggest the OAuth2 token is missing, expired, or invalid; reauthenticate or update credentials.

Links and References

Discussion