Actions72
- Image Actions
- Config Actions
- Container Actions
- Edge Group Actions
- Edge Stack Actions
- Network Actions
- Node Actions
- Registry Actions
- Secret Actions
- Service Actions
- Stack Actions
- Team Actions
- Template Actions
- User Actions
- Volume Actions
- Webhook Actions
Overview
This node integrates with the Portainer API to manage Docker-related resources. Specifically, for the Team - Get operation, it retrieves detailed information about a specific team by its ID. This is useful in scenarios where you want to fetch and use team data within your automation workflows, such as managing user groups, permissions, or auditing team configurations.
Practical example:
You might use this node to get details of a particular team before updating its members or permissions, or to display team information in a dashboard.
Properties
| Name | Meaning |
|---|---|
| Team ID | The unique identifier of the team to retrieve. |
Output
The node outputs the JSON response from the Portainer API representing the requested team's details. This typically includes fields such as the team's name, ID, and possibly other metadata related to the team configuration.
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 an HTTP GET request to the endpoint
/api/teams/{teamId}to fetch the team data.
Troubleshooting
Common issues:
- Invalid or missing Team ID: The node requires a valid team ID; ensure this is provided.
- Authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
- Network connectivity: Ensure the Portainer server is reachable from the n8n environment.
Common error messages:
404 Not Found: The specified team ID does not exist. Check the team ID value.401 Unauthorizedor403 Forbidden: Authentication failed or insufficient permissions. Confirm API key validity and access rights.500 Internal Server Error: Server-side issue; retry later or check Portainer logs.