Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Account Teams → Update Team Information

AI-generated

Overview

This node operation updates information about a specific team within an account. It is useful in scenarios where team details such as the team name, external system identifier, or hierarchical parent relationship need to be modified after creation. For example, you might use this node to rename a team, link it to an external system's ID for synchronization, or reorganize teams by changing their parent team.

Properties

Name Meaning
Account Id Identifier of the account to which the team belongs (required).
Team Id Identifier of the team to update (required).
Name New name of the team.
External Id Unique identifier of the team in an external system, useful for integration purposes.
Parent Id Unique identifier of the parent team, allowing hierarchical structuring of teams.

Output

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

Dependencies

  • Requires an API key credential for authentication with the external service.
  • The node uses a base URL configured in the credentials to send requests.
  • The node depends on an OpenAPI-based client library for request construction and execution.

Troubleshooting

  • Missing Required Fields: If "Account Id" or "Team Id" are not provided, the node will fail because these are mandatory to identify which team to update.
  • Invalid Identifiers: Providing incorrect or non-existent account or team IDs may result in errors from the API indicating that the resource was not found.
  • Authentication Errors: Ensure the API key credential is correctly set up and has sufficient permissions to update team information.
  • Network Issues: Connectivity problems can cause timeouts or failed requests; verify network access to the API endpoint.
  • API Response Errors: If the API returns validation errors (e.g., invalid format for externalId), review the input values for compliance with expected formats.

Links and References

  • Refer to the external API documentation for detailed information on team resource fields and update operations.
  • Consult n8n documentation on how to configure API key credentials and manage node inputs/outputs.

Discussion