Whoz icon

Whoz

Interact with Whoz talent management platform
Join our community

Actions25

Overview

This node integrates with the Whoz talent management platform, allowing users to perform various operations on different resources such as accounts, billing items, dossiers, talents, and tasks. Specifically, for the Dossier resource, it supports operations including creating, updating, deleting, retrieving a single dossier, and retrieving multiple dossiers.

The Delete Dossier operation removes a dossier (which represents an opportunity or deal) from the Whoz platform by its unique identifier. This is useful in scenarios where a deal is no longer relevant or was created in error and needs to be cleaned up from the system.

Practical example:
A recruitment agency uses this node to automate their workflow. When a deal (dossier) is closed or canceled, they trigger this node to delete the corresponding dossier from Whoz, ensuring their data stays current and accurate.

Properties

Name Meaning
Dossier ID The unique identifier of the dossier to delete. This is required to specify which dossier to remove.

Output

The output JSON contains at least the following fields upon successful deletion:

  • success: A boolean indicating whether the deletion was successful (true).
  • id: The ID of the deleted dossier.
  • Additional response data returned by the Whoz API may also be included.

No binary data output is produced by this operation.

Example output JSON:

{
  "success": true,
  "id": "12345"
}

Dependencies

  • Requires an active connection to the Whoz talent management platform via an OAuth2 API credential.
  • The node uses the Whoz API endpoint to perform dossier deletions.
  • The base URL depends on the environment setting (sandbox or production).
  • Proper API permissions are needed to delete dossiers.

Troubleshooting

  • Missing or invalid Dossier ID: The node requires a valid dossier ID to delete. If omitted or incorrect, the operation will fail with an error indicating missing required fields.
  • API authentication errors: Ensure that the OAuth2 credentials are correctly configured and have sufficient permissions.
  • Network or API errors: Temporary network issues or API downtime can cause failures. Retrying or checking Whoz service status may help.
  • Error messages: The node wraps API errors and provides descriptive messages. Common errors include "delete dossier" context messages indicating what operation failed.

Links and References

Discussion