Portainer

Overview

This node integrates with the Portainer API to manage Docker and Portainer resources programmatically. Specifically, for the Team - Create operation, it allows users to create a new team within Portainer by specifying the team's name.

Common scenarios where this node is beneficial include automating user and team management in Portainer environments, integrating team creation into CI/CD pipelines, or managing access control dynamically based on organizational changes.

For example, an organization can automate the provisioning of teams when onboarding new departments or projects, ensuring consistent team setup without manual intervention.

Properties

Output

The node outputs the JSON response returned by the Portainer API after creating the team. This typically includes details about the newly created team such as its unique ID, name, and other metadata provided by Portainer.

No binary data output is involved in this operation.

Dependencies

• Requires an API key credential for authenticating with the Portainer API.
• The base URL of the Portainer instance must be configured in the credentials.
• The node sends a POST request to the /teams endpoint of the Portainer API.

Troubleshooting

• Authentication errors: Ensure that the API key credential is valid and has sufficient permissions to create teams in Portainer.
• Invalid team name: The "Team Name" property is required; leaving it empty will cause the API to reject the request.
• Network issues: Verify connectivity to the Portainer server and that the base URL is correctly set.
• API errors: If the Portainer API returns an error (e.g., team name already exists), check the error message for details and adjust inputs accordingly.

Links and References

• Portainer API Documentation - Teams
• Portainer Official Website