Tallyfy icon

Tallyfy

Interact with Tallyfy workflow automation platform
Join our community

Actions54

Overview

This node integrates with the Tallyfy workflow automation platform to update the role of a user within an organization. It allows changing a user's role to one of the predefined roles such as Admin, Standard, or Light. This operation is useful in scenarios where you need to manage user permissions dynamically, for example:

  • Promoting a standard user to an admin to grant higher privileges.
  • Downgrading an admin to a standard or light user to restrict access.
  • Adjusting roles based on project requirements or organizational changes.

Practical example: Automatically update a user's role after they complete a training process or when their responsibilities change.

Properties

Name Meaning
User ID The unique identifier of the user whose role you want to update.
Role The new role to assign to the user. Options are: Admin, Standard, Light.

Output

The node outputs the JSON response from the Tallyfy API corresponding to the updated user role information. The structure typically includes details about the user and their updated role status. The output is provided as JSON data; no binary data is involved.

Example output snippet (conceptual):

{
  "id": "user-id",
  "email": "user@example.com",
  "role": "admin",
  "status": "active",
  ...
}

Dependencies

  • Requires an API key credential for authenticating with the Tallyfy API.
  • Needs the organization ID configured in the credentials.
  • The base URL defaults to https://go.tallyfy.com/api but can be overridden in credentials.

Troubleshooting

  • Common issues:

    • Invalid or missing User ID: Ensure the User ID is correct and exists in the organization.
    • Insufficient permissions: The API key used must have rights to update user roles.
    • Network or authentication errors: Verify API credentials and network connectivity.

  • Error messages:

    • "User not found": Check that the User ID is valid.
    • "Unauthorized" or "Forbidden": Confirm the API key has proper permissions.
    • "Invalid role value": Use one of the allowed roles: Admin, Standard, or Light.

Resolving these usually involves verifying input parameters, checking API credentials, and ensuring the user exists in the target organization.

Links and References

Discussion