mittwald icon

mittwald

Interact with mittwald mStudio API

Actions409

Overview

This node operation updates an existing Project Backup Schedule in the Backup resource. It allows users to modify details such as the schedule's description, execution timing (using crontab notation), and time-to-live (TTL). This is useful for managing automated backup tasks within a project, ensuring backups run on desired schedules and are retained for appropriate durations.

Practical examples include:

  • Changing the frequency of backups from daily to weekly.
  • Updating the description to better reflect the purpose of the backup schedule.
  • Adjusting the TTL to keep backups longer or shorter depending on storage policies.

Properties

Name Meaning
Project Backup Schedule Id The unique identifier of the Project Backup Schedule to update. This is required to specify which schedule to modify.
Description A textual description of the Project Backup Schedule. Cannot be changed if the schedule is marked as a system backup.
Schedule The execution schedule expressed in crontab notation (e.g., "5 4 * * *" means at 04:05 every day). System backups must have a daily schedule.
Ttl Time-to-live for the Project Backup Schedule, specified as a time string (e.g., "7d" for seven days).

Output

The node outputs JSON data representing the updated Project Backup Schedule object returned by the API after the update operation. This typically includes fields such as the schedule ID, description, schedule expression, TTL, and possibly metadata about the backup schedule status.

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for authentication with the mittwald mStudio API.
  • The node uses the base URL https://api.mittwald.de and expects JSON content-type headers.
  • Proper configuration of the API credential in n8n is necessary for successful requests.

Troubleshooting

  • Invalid Project Backup Schedule Id: If the provided ID does not exist or is malformed, the API will likely return an error indicating the schedule was not found. Verify the ID before updating.
  • Immutable Description Error: Attempting to change the description of a system backup schedule (isSystemBackup true) will fail. Ensure you only update descriptions for non-system backups.
  • Invalid Crontab Format: Providing an incorrect schedule string that does not conform to crontab syntax may cause validation errors. Use a valid cron expression.
  • TTL Format Issues: The TTL must be a valid time string (e.g., "7d", "24h"). Invalid formats can lead to request rejection.
  • Authentication Failures: Missing or invalid API credentials will prevent the node from connecting to the API. Confirm the API key is correctly set up in n8n.

Links and References

Discussion