Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Overview

This node operation updates the roles assigned to a specific member within an account team. It is useful in scenarios where you need to modify the permissions or responsibilities of a user in a team context, such as promoting a member to an admin role or restricting access by changing their roles. For example, if a team member's job function changes, this operation allows you to update their roles accordingly without removing and re-adding them.

Properties

Name Meaning
Account Id Identifier of the account to which the team belongs.
Team Id Identifier of the team where the member's role will be updated.
Member Id Identifier of the member whose roles are being updated (corresponds to userId in Payhawk).
Roles JSON array specifying the roles granted to the team member. Example: ["admin", "user"]

Output

The output contains a JSON object representing the updated state of the team member’s roles within the specified team. This typically includes confirmation of the new roles assigned and may include metadata about the member or team. The node does not output binary data.

Dependencies

  • Requires an API key credential for authenticating with the external service managing accounts and teams.
  • The base URL for the API must be configured in the node credentials.
  • The node depends on the external Payhawk API (or similar) to perform the update operation.

Troubleshooting

  • Invalid Identifiers: Errors may occur if the Account Id, Team Id, or Member Id do not exist or are incorrect. Verify these IDs before running the node.
  • Malformed Roles JSON: The Roles property expects valid JSON. Invalid JSON syntax will cause parsing errors. Use proper JSON formatting.
  • Insufficient Permissions: If the API key lacks permission to update team members, the request will fail. Ensure the API key has adequate rights.
  • API Connectivity Issues: Network problems or incorrect base URL configuration can prevent successful API calls. Check network connectivity and credential settings.

Links and References

Discussion