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 deletes user groups based on their names. It is useful in scenarios where you need to remove multiple groups from a system by specifying their exact names, such as cleaning up obsolete or unused groups in an access control or permission management system.

For example, if an organization wants to delete several project teams or department groups that are no longer active, this operation allows batch deletion by providing the group names.

Properties

Name Meaning
Names Names of groups to be deleted

The "Names" property expects a string containing the names of the groups that should be deleted. This is a required field.

Output

The output will contain the full HTTP response from the API call that deletes the specified groups. The json output field typically includes details about the success or failure of the deletion request. There is no indication that binary data is returned.

Dependencies

  • Requires an API key credential for authentication.
  • The node sends an HTTP DELETE request to the /groups endpoint with the group names provided as a query parameter.
  • The base URL for the API is configured via credentials and trimmed to avoid trailing slashes.

Troubleshooting

  • Common issues:

    • Providing group names that do not exist may result in errors or no action.
    • Incorrect formatting of the "Names" string could cause the API to reject the request.
    • Missing or invalid API authentication will prevent successful execution.
  • Error messages:

    • Authorization errors indicate missing or invalid API keys.
    • Validation errors may occur if the "Names" parameter is empty or malformed.
    • Network errors can happen if the API endpoint is unreachable.
  • Resolution:

    • Ensure the "Names" input is correctly formatted and non-empty.
    • Verify that the API key credential is valid and has sufficient permissions.
    • Check network connectivity and API endpoint availability.

Links and References

  • Refer to your API documentation for the /groups DELETE endpoint for more details on expected parameters and responses.
  • Consult your platform's authentication setup guide to configure the required API key credential.

Discussion