Portainer icon

Portainer

Interact with Portainer via API

Actions190

Stacks → Stack Update Git

AI-generated

Overview

This node operation allows updating a stack's Git configuration in Portainer. It is useful when you want to pull the latest changes from a Git repository and redeploy a stack automatically. Typical use cases include continuous deployment workflows where infrastructure stacks need to be updated based on changes pushed to a Git repository.

For example, after pushing new code or configuration files to a Git repository, this node can trigger Portainer to pull those changes and redeploy the corresponding stack without manual intervention.

Properties

Name Meaning
Id The unique identifier of the stack to update.
Body A JSON string containing Git configuration details used for pulling and redeploying the stack.
Additional Fields Optional extra parameters:
- Endpoint Id (Optional) The environment/endpoint identifier associated with the stack, required for stacks created before version 1.18.0.

Output

The node outputs JSON data representing the response from the Portainer API after attempting to update the stack's Git configuration. This typically includes status information about the update operation, such as success confirmation or error details.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the Portainer API.
  • The node expects the base URL of the Portainer instance to be configured in the credentials.
  • The Portainer API must be accessible from the n8n environment.

Troubleshooting

  • Invalid Stack Id: If the provided stack ID does not exist, the API will return an error. Verify the stack ID is correct.
  • Malformed Body: The Body property must be a valid JSON string with appropriate Git configuration fields. Invalid JSON or missing required fields will cause errors.
  • Missing Endpoint Id: For stacks created before Portainer version 1.18.0, the endpoint ID might be required. Omitting it may lead to failures.
  • Authentication Errors: Ensure the API key credential is valid and has sufficient permissions.
  • Network Issues: Confirm that the Portainer API URL is reachable from the n8n instance.

Links and References

Discussion