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 "Resets and Shares a Prompt Template to a New List of Users" allows you to reset the sharing permissions of a specific prompt template and then share it with a new list of users. This is useful when you want to revoke all previous user access to a prompt template and grant access only to a newly specified set of users.

Typical use cases include:

  • Managing access control for prompt templates in an organization.
  • Quickly updating which users can use or modify a prompt template.
  • Ensuring that outdated or unauthorized users no longer have access to sensitive or proprietary prompt templates.

For example, if a prompt template was previously shared with several users but now needs to be restricted to a different team, this operation will remove all old shares and assign the new user list in one action.

Properties

Name Meaning
Prompt Template ID The unique identifier of the prompt template to reset and share.
Additional Options Collection of optional parameters:
- Usernames A string containing usernames (likely comma-separated) representing the new users to share the prompt template with.

Output

The output of this operation typically includes the full HTTP response from the API call that performs the reset and share action. The JSON output field contains details about the success or failure of the operation, including any updated permission information related to the prompt template.

No binary data output is expected from this operation.

Dependencies

  • Requires an API key credential for authentication to the external service.
  • The node sends a PUT request to the endpoint /prompt_templates/{prompt_template_id}/permissions with the new list of usernames in the request body.
  • Proper configuration of the base URL and authentication credentials in n8n is necessary for successful API communication.

Troubleshooting

  • Invalid Prompt Template ID: If the provided prompt template ID does not exist or is incorrect, the API will return an error. Verify the ID before running the node.
  • Insufficient Permissions: The API key used must have sufficient permissions to modify prompt template sharing settings. Lack of permissions will cause authorization errors.
  • Malformed Usernames String: The usernames should be formatted correctly as expected by the API (e.g., comma-separated). Incorrect formatting may lead to partial or failed sharing.
  • Network Issues: Ensure network connectivity and correct API endpoint configuration to avoid connection errors.

Links and References

  • Refer to the API documentation of the prompt template permissions endpoint for detailed information on request format and response structure.
  • Consult your platform's user management and permission guides to understand how usernames should be specified.

This summary is based solely on static analysis of the provided source code and property definitions without runtime execution.

Discussion