h2oGPTe icon

h2oGPTe

h2oGPTe is an AI-powered search assistant for your internal teams to answer questions gleaned from large volumes of documents, websites and workplace content.

Actions198

Overview

This node operation creates a job to delete one or more documents identified by their unique IDs. It is useful in scenarios where you want to batch-delete documents asynchronously rather than deleting them immediately. This can be beneficial when managing large document repositories, allowing for scheduled or queued deletion jobs that do not block other operations.

For example, if you have a list of outdated or irrelevant documents and want to remove them from your system efficiently, this operation lets you submit a job specifying those document IDs for deletion.

Properties

Name Meaning
Document IDs A string containing the IDs of documents to be deleted. These IDs specify which documents will be targeted by the delete job.

Output

The output of this operation typically includes the response from the API indicating the status of the created delete job. The json output field will contain details about the job such as its unique identifier, status, and possibly metadata related to the deletion process.

If the node supports binary data output, it would represent any associated files or logs related to the job, but based on the provided information, this operation primarily deals with JSON responses.

Dependencies

  • Requires an API key credential for authentication to the external service.
  • The node sends a POST request to the endpoint /documents/delete_job with the specified document IDs in the request body.
  • Proper configuration of the base URL and authentication credentials in n8n is necessary for successful execution.

Troubleshooting

  • Common Issues:

    • Invalid or missing document IDs may cause the job creation to fail.
    • Authentication errors if the API key credential is not set up correctly.
    • Network or connectivity issues preventing access to the API endpoint.
  • Error Messages:

    • "Unauthorized" or "Authentication failed": Check that the API key credential is correctly configured.
    • "Invalid document IDs": Verify that the document IDs provided are correct and exist in the system.
    • "Failed to create delete job": Could indicate server-side issues or malformed requests; review the input parameters and try again.

Links and References

  • Refer to the API documentation of the document management system for details on the /documents/delete_job endpoint.
  • Consult n8n documentation on how to configure API key credentials and HTTP request nodes for integration.

Discussion