Portainer icon

Portainer

Interact with Portainer via API

Actions190

Registries → Registry Delete

AI-generated

Overview

This node allows users to delete a specific registry from Portainer by its identifier. It is useful in scenarios where you need to programmatically manage container registries within Portainer, such as cleaning up unused or obsolete registries to maintain an organized environment.

For example, if you have multiple container registries configured and want to automate the removal of one based on certain conditions (e.g., no longer used or deprecated), this node can be integrated into your workflow to perform that deletion via the Portainer API.

Properties

Name Meaning
Id The unique identifier of the registry to delete. This is a required numeric value specifying which registry will be removed.

Output

The node outputs JSON data representing the result of the delete operation. Typically, this would include confirmation of successful deletion or details about any error encountered. Since this is a delete operation, no binary data output is expected.

Dependencies

  • Requires an API key credential for authenticating with the Portainer API.
  • The node depends on the Portainer API being accessible at the URL provided in the credentials.
  • Uses the @devlikeapro/n8n-openapi-node package internally to build properties and handle requests.

Troubleshooting

  • Common issues:
    • Invalid or missing registry ID: Ensure the "Id" property is set correctly and corresponds to an existing registry.
    • Authentication errors: Verify that the API key credential is valid and has sufficient permissions to delete registries.
    • Network or connectivity problems: Confirm that the Portainer API endpoint URL is correct and reachable.
  • Error messages:
    • Unauthorized or forbidden errors indicate issues with API credentials or permissions.
    • Not found errors suggest the specified registry ID does not exist.
    • Timeout or connection errors point to network issues or incorrect base URL configuration.

Links and References

Discussion