mittwald icon

mittwald

Interact with mittwald mStudio API

Actions409

Overview

This node operation creates a new conversation within the mittwald mStudio API. It is useful for initiating discussions or threads categorized under specific topics or projects, allowing users to collaborate and share information effectively. For example, a team might use this node to start a conversation about a new project milestone, assign notification roles to alert relevant members, and share the conversation with specific users or groups.

Properties

Name Meaning
Category Id Identifier of the category under which the conversation will be created.
Main User Id Identifier of the primary user who owns or initiates the conversation.
Notification Roles JSON array specifying roles that should receive notifications about this conversation.
Related To Object indicating entities related to this conversation (e.g., aggregate, domain, id).
Shared With Object indicating entities with whom the conversation is shared (e.g., aggregate, domain, id).
Title The title or subject line of the conversation.

Output

The node outputs JSON data representing the newly created conversation object as returned by the mittwald mStudio API. This typically includes details such as the conversation ID, title, category, participants, timestamps, and other metadata. There is no indication that binary data is output by this node.

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:
    • Missing or invalid API authentication token can cause authorization errors.
    • Providing malformed JSON in the "Notification Roles" property may lead to parsing errors.
    • Omitting required fields like "Category Id" or "Main User Id" could result in API validation errors.
  • Error Messages:
    • Authorization errors typically indicate issues with the API key; verify credentials are correctly configured.
    • Validation errors from the API usually specify which field is missing or invalid; ensure all required properties are set properly.
    • JSON parsing errors suggest incorrect formatting in the "Notification Roles" input; validate JSON syntax before submission.

Links and References

Discussion