Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

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 organizational structure managed via an API. Practical examples include renaming a team after restructuring, linking a team to an external system by setting an external ID, or changing the hierarchy by assigning a new parent team.

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 for the team.
External Id Unique identifier of the team in an external system, allowing cross-system references.
Parent Id Unique identifier of the parent team, establishing hierarchical relationships.

Output

The node outputs JSON data representing the updated team information as returned by the API. This typically includes the updated fields such as the team’s name, external ID, parent ID, and any other metadata provided by the service. The output does not include binary data.

Dependencies

  • Requires an API key credential or similar authentication token configured in n8n to authorize requests.
  • Depends on connectivity to the external API managing groups and teams.
  • The base URL for the API must be set in the node credentials or environment configuration.

Troubleshooting

  • Missing Required Fields: Errors may occur if "Group Id" or "Team Id" are not provided. Ensure these identifiers are correctly set.
  • Authentication Failures: If the API key or token is invalid or missing, the node will fail to authenticate. Verify credentials are properly configured.
  • Invalid Identifiers: Providing non-existent group or team IDs will result in errors from the API. Confirm IDs are correct.
  • API Connectivity Issues: Network problems or incorrect base URL settings can cause request failures. Check network access and configuration.
  • Permission Denied: Insufficient permissions for updating team information may cause authorization errors. Ensure the API user has appropriate rights.

Links and References

  • Refer to the external API documentation for detailed information on the team update endpoint and required parameters.
  • Consult n8n documentation on how to configure API credentials and handle HTTP request nodes for custom integrations.

Discussion