Portainer

Interact with Portainer via API

Actions190

Auth Actions
- Authenticate User
- Validate O Auth
Backup Actions
- Backup
- Restore
Custom Templates Actions
- Custom Template List
- Custom Template Delete
- Custom Template Inspect
- Custom Template Update
- Custom Template File
- Custom Template Git Fetch
- Custom Template Create File
- Custom Template Create Repository
- Custom Template Create String
Docker Actions
- Docker Container Gpus Inspect
- Docker Dashboard
- Docker Images List
Edge Groups Actions
- Edge Group Create
- Edge Group Delete
- Edge Group Inspect
- Ege Group Update
Edge Jobs Actions
- Edge Job Delete
- Edge Job Inspect
- Edge Job Update
- Edge Job File
- Edge Job Tasks List
- Edge Job Tasks Clear
- Edge Job Task Logs Inspect
- Edge Job Tasks Collect
- Edge Job Create File
- Edge Job Create String
Edge Stacks Actions
- Edge Stack Delete
- Edge Stack Inspect
- Edge Stack Update
- Edge Stack File
- Edge Stack Status Update
- Edge Stack Create File
- Edge Stack Create Repository
- Edge Stack Create String
Endpoint Groups Actions
- Endpoint Group Delete
- Endpoint Group Update
- Endpoint Group Delete Endpoint
- Endpoint Group Add Endpoint
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
- Git Operation Repo File Preview
Helm Actions
- Helm List
- Helm Install
- Helm Delete
- Helm Repo Search
- Helm Show
- Helm User Repositories List
- Helm User Repository Create
- Helm User Repository Delete
Intel Actions
- Open AMT Configure
- Open AMT Activate
- Open AMT Devices
- Device Action
- Device Features
- Open AMT Host Info
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
- LDAP Check
Registries Actions
- Registry Create
- Registry Delete
- Registry Inspect
- Registry Update
- Registry Configure
Resource Controls Actions
- Resource Control Create
- Resource Control Delete
- Resource Control Update
Settings Actions
- Settings Update
Ssl Actions
- SSL Update
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
- Tag Create
- Tag Delete
Team Memberships Actions
- Team Membership Create
- Team Membership Delete
- Team Membership Update
- Team Memberships
Teams Actions
- Team List
- Team Create
- Team Delete
- Team Inspect
- Team Update
Templates Actions
- Template File
Upload Actions
- Upload TLS
Users Actions
- User List
- User Create
- User Delete
- User Inspect
- User Update
- User Memberships Inspect
- User Update Password
- User Get API Keys
- User Generate API Key
- User Remove API Key
- User Admin Init

Edge Stacks → Edge Stack Status Update

AI-generated

Overview

The "Edge Stack Status Update" operation in the Edge Stacks resource allows updating the status of a specific Edge Stack by sending a status payload. This node is useful for scenarios where you need to programmatically report or modify the current state of an Edge Stack within Portainer, such as signaling deployment progress, health checks, or other runtime status updates.

Practical examples include:

Automatically updating the status of an Edge Stack after a deployment script runs.
Reporting health or error states from monitoring tools back to Portainer.
Integrating with CI/CD pipelines to reflect the real-time status of edge deployments.

Properties

Name	Meaning
Id	The unique identifier (number) of the Edge Stack whose status you want to update.
Body	The status payload (string) containing the details of the Edge Stack status update. This should be a JSON string representing the status information to send.

Output

The node outputs the response from the Portainer API after attempting to update the Edge Stack status. The output is structured as JSON data reflecting the result of the update operation, which typically includes confirmation of the update or any error messages returned by the API.

This node does not output binary data.

Dependencies

Requires an active connection to a Portainer instance via its API.
Needs an API authentication token or key configured in n8n credentials to authorize requests.
The base URL of the Portainer API must be provided in the credentials configuration.

Troubleshooting

Invalid Id: If the provided Edge Stack Id does not exist or is incorrect, the API will return an error. Verify the Id before running the node.
Malformed Body: The Body property must be a valid JSON string. Invalid JSON will cause the request to fail. Use JSON validation tools to ensure correctness.
Authentication Errors: Missing or invalid API credentials will prevent the node from connecting to Portainer. Ensure the API key/token and URL are correctly set.
Network Issues: Connectivity problems between n8n and the Portainer server can cause timeouts or failures. Check network access and firewall settings.
API Version Mismatch: Using incompatible Portainer API versions may lead to unexpected errors. Confirm that the API version matches what the node expects.

Links and References

Portainer API Documentation
Portainer Edge Stacks Overview
n8n Documentation on HTTP Request Nodes (for understanding API interactions)

PortainerInstall