Actions100
- Project Actions
- Project Accept Project Invite
- Project Create Project Invite
- Project List Invites For Project
- Project Create Project
- Project Decline Project Invite
- Project Delete Project Avatar
- Project Request Project Avatar Upload
- Project Delete Project Invite
- Project Get Project Invite
- Project Delete Project Membership
- Project Get Project Membership
- Project Update Project Membership
- Project Delete Project
- Project Get Project
- Project Delete Server Avatar
- Project Request Server Avatar Upload
- Project Get Project Token Invite
- Project Get Self Membership For Project
- Project Get Server
- Project List Memberships For Project
- Project List Project Invites
- Project List Project Memberships
- Project List Projects
- Project List Servers
- Project Resend Project Invite Mail
- Project Update Project Description
- Project Update Server Description
- Storagespace Get Project Statistics
- Storagespace Get Server Statistics
- Storagespace Replace Project Notification Threshold
- Storagespace Replace Server Notification Threshold
- Backup Actions
- Backup Create Project Backup Export
- Backup Delete Project Backup Export
- Backup Create Project Backup Schedule
- Backup List Project Backup Schedules
- Backup Create Project Backup
- Backup List Project Backups
- Backup Delete Project Backup Schedule
- Backup Get Project Backup Schedule
- Backup Update Project Backup Schedule
- Backup Delete Project Backup
- Backup Get Project Backup
- Backup Update Project Backup Description
- SSH SFTP User Actions
- Cronjob Actions
- App Actions
- App Execute Action
- App Get App
- App Get Appinstallation
- App Patch Appinstallation
- App Uninstall Appinstallation
- App Get Appversion
- App Get Installed Systemsoftware For Appinstallation
- App Get Missing Dependencies For Appinstallation
- App Get Systemsoftware
- App Get Systemsoftwareversion
- App Link Database
- App List Appinstallations For User
- App List Appinstallations
- App Request Appinstallation
- App List Apps
- App List Appversions
- App List Systemsoftwares
- App List Systemsoftwareversions
- App List Update Candidates For Appversion
- App Replace Database
- App Request Appinstallation Copy
- App Retrieve Status
- App Unlink Database
- App Set Database Users
- Project File System Actions
- Contract Actions
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
andskip
) 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
- mittwald mStudio API Documentation (official API docs for detailed endpoint info)
- n8n documentation on creating custom nodes for further customization guidance