mittwald icon

mittwald

Interact with mittwald mStudio API

Actions409

Overview

This node allows you to create a new Cronjob within a specified project using the mittwald mStudio API. It is useful for automating scheduled tasks such as triggering webhooks, running periodic data syncs, or executing maintenance scripts at defined intervals.

Typical use cases include:

  • Scheduling HTTP requests to your services at regular intervals.
  • Automating notifications or alerts based on time schedules.
  • Managing recurring jobs in projects hosted on the mittwald platform.

For example, you can configure this node to create a cronjob that calls a URL every 5 minutes to trigger a backup process or refresh cached data.

Properties

Name Meaning
Project Id The ID of the project where the cronjob will be created.
Active Whether the cronjob should be active immediately after creation (true/false).
App Id Identifier of the application associated with the cronjob.
Description A textual description of the cronjob's purpose.
Destination JSON object defining the destination URL and related settings where the cronjob sends requests. Example: { "url": "https://mydomain.com" }
Email Optional email address to receive notifications related to the cronjob.
Failed Execution Alert Threshold Number specifying how many failed executions trigger an alert notification.
Interval Cron expression string defining how often the cronjob runs (e.g., "*/5 * * * *" for every 5 minutes).
Timeout Timeout duration in seconds for the cronjob execution before it is considered failed.

Output

The node outputs JSON data representing the newly created cronjob resource as returned by the mittwald mStudio API. This typically includes details such as the cronjob ID, status, configuration parameters, and timestamps.

If the API supports binary data output, it would be summarized here; however, based on the provided code and properties, the output is purely JSON.

Dependencies

  • Requires an API key credential for authenticating with the mittwald mStudio API.
  • The node uses the base URL https://api.mittwald.de for all requests.
  • Proper network access to the mittwald API endpoint is necessary.
  • The node depends on the @devlikeapro/n8n-openapi-node package for OpenAPI integration.

Troubleshooting

  • Invalid Project Id or App Id: Ensure the IDs are correct and exist in your mittwald account.
  • Malformed Destination JSON: The destination property must be valid JSON; otherwise, the request will fail.
  • Incorrect Cron Expression: The interval must be a valid cron syntax; invalid expressions will cause errors.
  • Timeout Issues: Setting timeout too low may cause premature failures; adjust according to expected job duration.
  • Authentication Errors: Verify that the API key credential is correctly configured and has sufficient permissions.
  • Network Connectivity: Check firewall or proxy settings if the node cannot reach the mittwald API.

Common error messages usually relate to validation failures or authentication issues and can be resolved by verifying input values and credentials.

Links and References

Discussion