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 provides an interface to interact with a document management API, specifically focusing on the "Document" resource and the operation to count the number of documents accessible to the user. It allows users to retrieve the total count of documents, optionally filtering to count only those documents owned by the authenticated user.

This functionality is useful in scenarios where you need to monitor or report on the volume of documents managed within a system, such as generating usage statistics, auditing document ownership, or managing quotas.

For example, a user might want to:

  • Get the total number of documents they have access to.
  • Get the count of documents they personally own for reporting or quota enforcement.

Properties

Name Meaning
Additional Options Collection of optional parameters:
- Owned Boolean flag; if true, counts only documents owned by the user.

The "Additional Options" property includes:

  • Owned: When set to true, the count will include only documents that are owned by the current user. If false or omitted, the count includes all documents accessible to the user.

Output

The node outputs a JSON object containing the count of documents. The exact structure depends on the API response but typically includes a numeric field representing the total number of documents matching the criteria.

Example output JSON:

{
  "count": 123
}

There is no indication that this node outputs binary data.

Dependencies

  • Requires an API key credential for authentication to the external document management API.
  • The base URL for API requests is configured from the credentials.
  • The node sends HTTP GET requests to the endpoint /documents/count with optional query parameters.

Troubleshooting

  • Authentication errors: Ensure that a valid API key credential is provided and has sufficient permissions to access document counts.
  • Permission issues: If counting owned documents returns zero unexpectedly, verify that the user owns any documents or that the "Owned" option is set correctly.
  • Network or timeout errors: Check network connectivity and API server availability. Adjust timeout settings if available.
  • Invalid parameter errors: Confirm that the "Owned" option is a boolean value.

Links and References

  • Refer to the external API documentation for the /documents/count endpoint for detailed information on request parameters and response format.
  • Consult your API provider's authentication guide for setting up the required API key credential.

Discussion