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 updates an existing Project Backup Schedule in the Backup resource. It allows users to modify details such as the description, execution schedule (in crontab format), and the time-to-live (TTL) of a backup schedule associated with a project. This is useful for automating and managing backup routines by adjusting when backups occur and how long they are retained.
Practical examples include:
- Changing the frequency of backups from daily to weekly.
- Updating the description to better reflect the purpose or contents of the backup schedule.
- Adjusting the TTL to retain backups for a longer or shorter period depending on storage policies.
Properties
| Name | Meaning |
|---|---|
| Project Backup Schedule Id | The unique identifier of the ProjectBackupSchedule to be updated. This is required to specify which schedule to update. |
| Description | A textual description of the ProjectBackupSchedule. Note that descriptions for system backup schedules cannot be changed. |
| Schedule | The execution schedule expressed in crontab notation (e.g., "5 4 * * *" means at 04:05 every day). System backup schedules must have a daily once schedule. |
| Ttl | Time-to-live for the ProjectBackupSchedule, specified as a time string (e.g., "7d" for seven days). This defines how long backups are retained. |
Output
The node outputs JSON data representing the updated ProjectBackupSchedule object after the update operation completes successfully. This typically includes fields such as the ID, description, schedule, TTL, and possibly metadata about the update status.
No binary data output is indicated for this operation.
Dependencies
- Requires an API key credential for authenticating with the mittwald mStudio API.
- The node uses the mittwald mStudio API endpoint
https://api.mittwald.de. - Proper configuration of the API authentication credentials within n8n is necessary.
- The node expects the input properties to be correctly formatted, especially the cron schedule and TTL strings.
Troubleshooting
- Invalid Project Backup Schedule Id: If the provided ID does not exist or is incorrect, the API will likely return an error indicating the schedule was not found. Verify the ID before running the node.
- Immutable Description for System Backups: Attempting to change the description of a system backup schedule (marked as
isSystemBackup) will fail. Ensure you only update descriptions for non-system backups. - Incorrect Cron Format: Providing an invalid cron expression in the Schedule property may cause scheduling errors or API rejection. Validate cron syntax before submission.
- TTL Format Errors: The TTL must be a valid time string (e.g., "7d", "24h"). Invalid formats may cause the API to reject the request.
- Authentication Failures: Ensure the API key credential is valid and has sufficient permissions to update backup schedules.
- API Rate Limits or Downtime: Network issues or API rate limits can cause failures; retry or check API status if persistent errors occur.
Links and References
- Crontab Guru - Cron Expression Editor — Useful for creating and validating cron schedules.
- mittwald mStudio API documentation (refer to your internal or official API docs for detailed endpoints and payloads).
- n8n Documentation on Credentials and HTTP Request nodes for setting up API authentication.