mittwald icon

mittwald

Interact with mittwald mStudio API

Actions100

Overview

This node operation, Project List Memberships For Project, retrieves a list of memberships associated with a specific project from the mittwald mStudio API. It is useful for scenarios where you need to manage or audit user roles and access within a project, such as verifying who has access, filtering members by role or security settings, or paginating through large membership lists.

Practical examples include:

  • Fetching all owners of a project to notify them about an update.
  • Listing external collaborators with limited access.
  • Filtering memberships that have multi-factor authentication enabled for security audits.
  • Paginating through memberships when there are many users assigned to a project.

Properties

Name Meaning
Project Id ID of the Project to list memberships for.
Limit Maximum number of memberships to return (pagination).
Skip Number of memberships to skip before starting to collect the result set (pagination offset).
Has Expiry Filter memberships based on whether they have an expiry date (true or false).
Is Inherited Filter memberships based on whether they are inherited (true) or directly assigned (false).
Role Filter memberships by role. Options: Notset, Owner, Emailadmin, External.
Has Mfa Filter memberships based on whether the member has multi-factor authentication enabled (true or false).

Output

The output JSON contains an array of membership objects corresponding to the filtered list of project memberships. Each membership object typically includes details such as user information, role, expiry status, inheritance status, and MFA status.

If binary data were returned (not indicated here), it would represent attachments or files related to memberships, but this operation focuses on JSON data only.

Dependencies

  • Requires an API key credential for authenticating with the mittwald mStudio API.
  • The node uses the base URL https://api.mittwald.de.
  • No additional environment variables are explicitly required beyond the API authentication setup.

Troubleshooting

  • Common issues:

    • Invalid or missing Project Id will cause the API call to fail or return no results.
    • Incorrect API credentials will lead to authentication errors.
    • Using incompatible filter values (e.g., unsupported role names) may result in empty responses or errors.
    • Pagination parameters (limit and skip) must be non-negative integers; otherwise, the API might reject the request.
  • Error messages:

    • Authentication errors: Check that the API key credential is correctly configured and valid.
    • "Project not found" or similar: Verify the Project Id is correct and accessible by the authenticated user.
    • Validation errors on query parameters: Ensure filters like role, hasExpiry, and hasMfa are set to supported values.

Links and References

Discussion