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 roles based on given role names. It is useful in scenarios where you need to remove multiple roles from a system by specifying their names, such as cleaning up unused or obsolete roles in an access control system. For example, if an organization wants to revoke certain permissions associated with specific roles, this operation allows bulk deletion by providing the role names.

Properties

Name Meaning
Names Names of roles to be deleted

The "Names" property expects a string containing one or more role names that should be deleted.

Output

The output will contain the response from the API after attempting to delete the specified roles. The json field typically includes status information about the deletion operation, such as success confirmation or error details. There is no indication that binary data is returned for this operation.

Dependencies

  • Requires an API key credential for authentication.
  • The node sends an HTTP DELETE request to the /roles endpoint with the role names provided as query parameters.
  • The base URL and headers are configured via credentials and node settings.

Troubleshooting

  • Common issues:

    • Providing invalid or non-existent role names may result in errors or no roles being deleted.
    • Insufficient permissions or missing API key credential can cause authorization failures.
    • Network connectivity issues can prevent successful API calls.
  • Error messages:

    • Authorization errors indicate missing or invalid API credentials; ensure the API key is correctly configured.
    • Validation errors may occur if the "Names" parameter is empty or malformed; verify that role names are correctly specified.
    • Server errors might require retrying or checking the API service status.

Links and References

  • Refer to your API documentation for the /roles DELETE endpoint for detailed behavior and response formats.
  • Consult your system's role management guide for best practices on role deletion and permission handling.

Discussion