mittwald icon

mittwald

Interact with mittwald mStudio API

Actions409

Overview

This node interacts with the mittwald mStudio API to list notifications filtered by various criteria. It is useful for workflows that need to retrieve and process user or system notifications, such as monitoring unread alerts, filtering by severity or type, or paginating through large sets of notifications.

Practical examples include:

  • Automatically fetching unread notifications to trigger follow-up actions.
  • Filtering notifications by severity to prioritize critical alerts.
  • Paginating through notifications in batches for reporting or archival purposes.

Properties

Name Meaning
Status Filter notifications by their read status. Options: Unread, Read.
Severity Filter notifications by severity level(s). Accepts a JSON array of severities.
Type Filter notifications by type(s). Accepts a JSON array of types.
Type Not Exclude notifications of certain type(s). Accepts a JSON array of types to exclude.
Limit Maximum number of notifications to return in one response. Default is 500.
Skip Number of items to skip (offset). Should be a multiple of limit for pagination.
Page Page number to display. If both page and skip are set, skip takes precedence.

Output

The node outputs a JSON array of notification objects matching the specified filters. Each object represents a notification with its details as returned by the mittwald mStudio API.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the mittwald mStudio API.
  • The base URL for API requests is https://api.mittwald.de.
  • The node uses standard HTTP headers for JSON content (Accept: application/json, Content-Type: application/json).

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication errors.
    • Providing invalid JSON arrays for Severity, Type, or Type Not filters may result in request failures.
    • Pagination parameters (limit, skip, page) must be used correctly; skip should be a multiple of limit.

  • Error messages:

    • Authentication errors typically indicate problems with the API key setup.
    • Validation errors may occur if filter values are malformed or unsupported by the API.
    • Rate limiting or server errors from the API should be handled by retrying after some delay.

Links and References

Discussion