Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Group Teams → Delete Team

AI-generated

Overview

This node operation deletes a specific team within a group. It is useful in scenarios where you need to manage organizational structures dynamically, such as removing obsolete or disbanded teams from a group in an external system. For example, if a project team is dissolved, this operation can be used to clean up the team's presence in the group management system.

Properties

Name Meaning
Group Id Identifier of the Group
Team Id Identifier of the Team to be deleted

Output

The output JSON typically contains the response from the API confirming the deletion of the specified team. This may include status information or confirmation messages. The node does not output binary data.

Dependencies

  • Requires an API key credential for authentication with the external service managing groups and teams.
  • The base URL for the API must be configured in the node credentials or environment.
  • The node depends on an OpenAPI-based client library to interact with the API.

Troubleshooting

  • Common issues:
    • Invalid or missing Group Id or Team Id will cause the operation to fail.
    • Authentication errors if the API key or credentials are incorrect or expired.
    • Network connectivity problems preventing access to the API endpoint.
  • Error messages:
    • "Team not found" indicates the specified Team Id does not exist within the given Group Id.
    • "Unauthorized" or "Authentication failed" suggests issues with the provided API credentials.
  • Resolutions:
    • Verify that both Group Id and Team Id are correct and exist.
    • Ensure the API key or authentication token is valid and has necessary permissions.
    • Check network settings and API endpoint availability.

Links and References

  • Refer to the external API documentation for detailed information about group and team management endpoints.
  • Consult n8n documentation on how to configure API credentials and use OpenAPI nodes.

Discussion