Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Group Teams → Update Team Information

AI-generated

Overview

This node operation updates information about a specific team within a group. It is useful when you need to modify team details such as the team's name, external identifier, or its parent team relationship in an external system that manages groups and teams. For example, if a team's name changes or it is reorganized under a different parent team, this operation allows you to keep your data synchronized by updating those details programmatically.

Properties

Name Meaning
Group Id Identifier of the Group to which the team belongs.
Team Id Identifier of the team to update.
Name New name of the team.
External Id Unique identifier of the team in the external system.
Parent Id Unique identifier of the parent team, representing hierarchical relationships if any.

Output

The output JSON contains the updated team information after the operation completes successfully. This typically includes the team's identifiers and any updated fields such as name, external ID, and parent ID. The node does not explicitly handle binary data for this operation.

Dependencies

  • Requires an API key credential or similar authentication token configured in n8n to authorize requests to the external service managing groups and teams.
  • The node uses HTTP requests with JSON payloads to communicate with the external API endpoint.
  • Proper base URL configuration for the external API must be set in the credentials.

Troubleshooting

  • Missing Required Fields: Ensure both "Group Id" and "Team Id" are provided; these are mandatory to identify the team to update.
  • Invalid Identifiers: If the group or team IDs do not exist or are incorrect, the API will likely return an error indicating resource not found.
  • Authentication Errors: Verify that the API key or authentication token is valid and has sufficient permissions to update team information.
  • Network Issues: Check connectivity to the external API endpoint and ensure no firewall or proxy blocks the request.
  • API Response Errors: Review error messages returned from the API for clues on invalid input or server-side issues.

Links and References

  • Refer to the external system's API documentation for detailed information on the team update endpoint, required parameters, and response structure.
  • n8n documentation on how to configure API credentials and use HTTP request nodes may also be helpful.

Discussion