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 Jobs → Edge Job Update

AI-generated

Overview

This node operation updates an existing Edge Job in Portainer, a container management platform. It is useful when you need to modify the configuration or parameters of a specific Edge Job by providing its unique identifier and the updated data payload. Typical use cases include automating deployment updates, changing job schedules, or adjusting runtime settings for edge computing environments managed through Portainer.

Properties

Name	Meaning
Id	The unique numeric identifier of the Edge Job to update. This is required to specify which Edge Job will be modified.
Body	A JSON string representing the new data for the Edge Job. This contains the updated configuration details that will replace the current job data.

Output

The node outputs the response from the Portainer API after attempting to update the Edge Job. The json output field typically contains the updated Edge Job object or confirmation details returned by the API. There is no indication that binary data is handled or returned by this operation.

Dependencies

Requires an active connection to a Portainer instance via its API.
Needs an API key credential configured in n8n to authenticate requests against the Portainer API.
The base URL for the Portainer API must be set in the credentials.
The node uses standard HTTP headers for JSON content negotiation.

Troubleshooting

Invalid Id: If the provided Edge Job Id does not exist, the API will likely return an error indicating the resource was not found. Verify the Id before running the node.
Malformed Body: The Body property must be a valid JSON string representing the Edge Job data. Invalid JSON or missing required fields can cause the update to fail.
Authentication Errors: Ensure the API key credential is correctly configured and has sufficient permissions to update Edge Jobs.
API Connectivity Issues: Network problems or incorrect base URL settings can prevent successful communication with the Portainer API.
Error Messages: Common errors may include 400 Bad Request (invalid input), 401 Unauthorized (authentication failure), or 404 Not Found (invalid Edge Job Id). Review the error message details to adjust inputs or credentials accordingly.

Links and References

Portainer API Documentation
Portainer Edge Jobs Overview
n8n HTTP Request Node Documentation (for understanding API interaction)

PortainerInstall