Actions190
- Auth Actions
- Backup Actions
- Custom Templates Actions
- Docker Actions
- Edge Groups Actions
- Edge Jobs Actions
- Edge Stacks Actions
- Endpoint Groups Actions
- Endpoints Actions
- Endpoint Delete Batch
- Endpoint List
- Endpoint Create
- Endpoint Delete
- Endpoint Inspect
- Endpoint Update
- Endpoint Association Delete
- Endpoint Dockerhub Status
- Endpoint Edge Status Inspect
- Endpoint Force Update Service
- Endpoint Registries List
- Endpoint Registry Access
- Endpoint Settings Update
- Endpoint Snapshot
- Endpoint Update Relations
- Gitops Actions
- Helm Actions
- Intel Actions
- Kubernetes Actions
- Get All Kubernetes Applications
- Get All Kubernetes Applications Count
- Delete Cluster Role Bindings
- Delete Cluster Roles
- Get All Kubernetes Cluster Role Bindings
- Get All Kubernetes Cluster Roles
- Get All Kubernetes Config Maps
- Get All Kubernetes Config Maps Count
- Get Kubernetes Cron Jobs
- Delete Cron Jobs
- Get Kubernetes Dashboard
- Get All Kubernetes Ingress Controllers
- Update Kubernetes Ingress Controllers
- Get All Kubernetes Cluster Ingresses
- Get All Kubernetes Cluster Ingresses Count
- Delete Kubernetes Ingresses
- Get Kubernetes Jobs
- Delete Jobs
- Get Kubernetes Max Resource Limits
- Get Applications Resources
- Get Kubernetes Metrics For All Nodes
- Get Kubernetes Metrics For Node
- Get Kubernetes Metrics For All Pods
- Get Kubernetes Metrics For Pod
- Delete Kubernetes Namespace
- Get Kubernetes Namespaces
- Create Kubernetes Namespace
- Update Kubernetes Namespace Deprecated
- Get Kubernetes Namespace
- Update Kubernetes Namespace
- Get Kubernetes Config Map
- Get Kubernetes Ingress Controllers By Namespace
- Update Kubernetes Ingress Controllers By Namespace
- Get All Kubernetes Ingresses
- Create Kubernetes Ingress
- Update Kubernetes Ingress
- Get Kubernetes Ingress
- Get Kubernetes Secret
- Get Kubernetes Services By Namespace
- Create Kubernetes Service
- Update Kubernetes Service
- Kubernetes Namespaces Toggle System
- Get Kubernetes Volumes In Namespace
- Get Kubernetes Namespaces Count
- Get Kubernetes Nodes Limits
- Get Kubernetes RBAC Status
- Delete Role Bindings
- Get Kubernetes Role Bindings
- Get Kubernetes Roles
- Delete Roles
- Get Kubernetes Secrets
- Get Kubernetes Secrets Count
- Delete Service Accounts
- Get Kubernetes Service Accounts
- Get Kubernetes Services
- Get All Kubernetes Services Count
- Delete Kubernetes Services
- Get All Kubernetes Volumes
- Get Kubernetes Volume
- Get All Kubernetes Volumes Count
- Get Kubernetes Config
- Ldap Actions
- Registries Actions
- Resource Controls Actions
- Settings Actions
- Ssl Actions
- Stacks Actions
- Stack List
- Stack Delete
- Stack Inspect
- Stack Update
- Stack Associate
- Stack File Inspect
- Stack Update Git
- Stack Git Redeploy
- Stack Migrate
- Stack Start
- Stack Stop
- Stack Create Kubernetes Git
- Stack Create Kubernetes File
- Stack Create Kubernetes Url
- Stack Create Docker Standalone File
- Stack Create Docker Standalone Repository
- Stack Create Docker Standalone String
- Stack Create Docker Swarm File
- Stack Create Docker Swarm Repository
- Stack Create Docker Swarm String
- Stack Delete Kubernetes By Name
- Webhook Invoke
- Tags Actions
- Team Memberships Actions
- Teams Actions
- Templates Actions
- Upload Actions
- Users Actions
Stacks → Stack Migrate
AI-generatedOverview
The "Stack Migrate" operation in the Stacks resource allows migrating a stack within Portainer by sending migration details to the API. This node is useful when you need to update or move stack configurations programmatically, for example, during environment upgrades or when reorganizing stacks across different endpoints.
Practical examples include:
- Migrating a stack's configuration to a new environment endpoint.
- Updating stack definitions as part of an automated deployment pipeline.
- Adjusting stack metadata or settings that require migration support.
Properties
| Name | Meaning |
|---|---|
| Id | The unique identifier of the stack to migrate. |
| Body | JSON string containing the stack migration details. This should include all necessary data describing how the stack should be migrated. |
| Additional Fields | Optional parameters; currently supports: • Endpoint Id: For stacks created before version 1.18.0 that might lack an associated environment (endpoint) identifier, this sets the environment (endpoint) ID used by the stack. |
Output
The node outputs JSON data representing the response from the Portainer API after attempting the stack migration. This typically includes confirmation of the migration status, updated stack details, or error information if the migration failed.
No binary data output is expected from this operation.
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 and support the stack migration endpoint.
Troubleshooting
Common issues:
- Invalid or missing stack Id can cause the API call to fail.
- Malformed JSON in the Body property will result in request errors.
- Using an outdated or incorrect Endpoint Id may lead to migration failures or unexpected behavior.
- Network connectivity issues or incorrect API URL/credentials will prevent successful communication.
Error messages:
- Authentication errors indicate invalid or missing API credentials.
- Validation errors from the API often point to incorrect or incomplete migration details in the Body.
- Not found errors suggest the specified stack Id does not exist.
Resolution tips:
- Verify the stack Id is correct and exists in Portainer.
- Ensure the Body contains valid JSON matching the expected migration schema.
- Confirm the Endpoint Id is accurate if used.
- Check API credentials and network connectivity.