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 allows users to list backups associated with a specific project in the mittwald mStudio API. It is useful for retrieving and managing backup data, such as viewing available backups, filtering them by search terms, and sorting or paginating through large sets of backups. Practical applications include automating backup audits, monitoring backup availability, or integrating backup information into broader workflows.
Properties
| Name | Meaning |
|---|---|
| Project Id | The unique identifier of the project for which backups are to be listed. (Required) |
| Search Term | A text string to filter backups by matching against their id or description fields. |
| With Exports Only | Boolean flag to list only backups that include exports. Defaults to true. |
| Sort Order | Defines the order in which backups are listed: "Oldest First" or "Newest First". |
| Limit | Maximum number of backup records to return in the response. Default is 1000. |
| Skip | Number of items to skip before starting to collect the result set. Should be a multiple of limit. |
| Page | Page number to display; functions similarly to skip. If both page and skip are set, skip takes precedence. |
Output
The output JSON contains a list of backup objects corresponding to the specified project and filters. Each backup object includes details such as its ID, description, export status, creation date, and other metadata provided by the mittwald mStudio API. This structured data can be used downstream in workflows for reporting, further processing, or conditional logic.
If the node supports binary data output (not indicated here), it would typically represent downloadable backup files or related artifacts, but this operation focuses on listing metadata only.
Dependencies
- Requires an API key credential for authenticating with the mittwald mStudio API.
- The node uses the base URL
https://api.mittwald.defor API requests. - No additional external dependencies beyond the configured API authentication.
Troubleshooting
- Missing or invalid Project Id: The operation requires a valid project ID. Ensure the project ID is correctly provided and exists in the mittwald system.
- API Authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions.
- Pagination issues: When using
skipandlimit, ensureskipis a multiple oflimitto avoid unexpected results. - Empty results: If no backups are returned, check if the project actually has backups or adjust the
searchTermandwithExportsOnlyfilters. - Rate limiting or network errors: Handle API rate limits or connectivity problems by implementing retries or backoff strategies in your workflow.
Links and References
- mittwald mStudio API Documentation (official API docs)
- n8n documentation on HTTP Request Node for understanding API integrations
- General best practices for pagination and filtering in REST APIs