mittwald icon

mittwald

Interact with mittwald mStudio API

Actions409

Overview

This node operation allows users to create a scheduled backup for a specific project within the mittwald mStudio environment. It is useful for automating regular backups of project data, ensuring data safety and recovery options without manual intervention. For example, a user can set up a daily backup schedule for a web development project to prevent data loss in case of server failure or accidental deletion.

Properties

Name Meaning
Project Id The unique identifier of the project for which the backup schedule will be created.
Description Optional text describing the backup schedule for easier identification.
Schedule The execution timing of the backup in crontab notation (e.g., "5 4 * * *" for daily at 4:05 AM).
Ttl Time-to-live duration string specifying how long the backup should be retained (e.g., "7d" for seven days).

Output

The node outputs JSON data representing the newly created backup schedule resource. This typically includes details such as the schedule ID, associated project ID, description, cron schedule, TTL, creation timestamps, and status information. There is no indication that this node outputs binary data.

Dependencies

  • Requires an API key credential to authenticate with the mittwald mStudio API.
  • The node uses the base URL https://api.mittwald.de for all requests.
  • The node depends on the mittwald mStudio API being available and accessible.
  • No additional external dependencies are indicated beyond the API access.

Troubleshooting

  • Invalid Project Id: If the provided project ID does not exist or is incorrect, the API may return an error indicating the project was not found. Verify the project ID before running the node.
  • Incorrect Cron Syntax: Providing an invalid cron expression in the Schedule property may cause scheduling errors or rejection by the API. Use a valid crontab format.
  • TTL Format Issues: The TTL must be a valid time string (e.g., "7d", "24h"). Invalid formats may cause the API to reject the request.
  • Authentication Errors: Ensure the API key credential is correctly configured and has sufficient permissions to create backup schedules.
  • Network or API Downtime: Temporary connectivity issues or API service outages will cause failures; retry after some time.

Links and References

  • Crontab Guru - Cron Expression Editor — helpful for creating and validating cron schedules.
  • mittwald mStudio API documentation (not publicly linked here) — refer to your internal API docs for detailed backup schedule resource schema and constraints.

Discussion