PortainerInstall

Overview

This node operation deletes a tag identified by its unique ID. It is useful in scenarios where you need to programmatically remove tags from your system, such as cleaning up unused or obsolete tags, managing tag lifecycle, or automating tag maintenance workflows.

For example, if you have an automation that removes outdated labels from resources or categorizes items dynamically, this operation allows you to delete specific tags by their identifier.

Properties

The "Id" property specifies the unique numeric identifier of the tag to be deleted. This is a required input.

Output

The output JSON will typically contain the response from the API after attempting to delete the tag. This may include confirmation of deletion or error details if the operation failed.

No binary data output is expected from this operation.

Dependencies

• Requires an API key credential for authenticating with the Portainer API.
• The node uses the Portainer API endpoint configured via credentials, specifically targeting the /api base URL.
• The node depends on the @devlikeapro/n8n-openapi-node package and an OpenAPI specification (openapi.json) for request building.

Troubleshooting

• Common issues:

  • Providing an invalid or non-existent tag ID will likely result in an error response from the API.
  • Missing or incorrect API authentication credentials will cause authorization failures.
  • Network connectivity issues to the Portainer API endpoint can prevent successful requests.

• Error messages:

  • Errors related to "Tag not found" indicate the specified ID does not exist.
  • Authentication errors suggest problems with the provided API key or token.

• Resolutions:

  • Verify the tag ID exists before attempting deletion.
  • Ensure valid API credentials are configured in n8n.
  • Check network access and API endpoint URL correctness.

Links and References

• Portainer API Documentation
• n8n Documentation on Credentials