mittwald icon

mittwald

Interact with mittwald mStudio API

Actions409

Overview

This node operation allows creating an API token for a user in the system. The API token can be used to authenticate and authorize API requests with specific roles and an optional expiration date. This is useful when you want to programmatically access or integrate with the system on behalf of a user, granting limited or scoped permissions.

Practical examples include:

  • Generating a read-only API token for automated reporting tools.
  • Creating tokens with custom roles for third-party integrations.
  • Setting tokens that expire after a certain period for temporary access.

Properties

Name Meaning
Description A text description for the API token, e.g., "Api Token - read".
Expires At Optional expiration date/time for the token; if set, the token will become invalid after this time.
Roles JSON array defining the access rights assigned to the API token. Example: ["api_read"].

Output

The node outputs JSON data representing the newly created API token object. This typically includes fields such as the token string itself, its description, roles, expiration date, and possibly metadata like creation timestamp or token ID.

No binary data output is involved.

Dependencies

  • Requires an API key credential to authenticate against the mittwald mStudio API.
  • The node uses the mittwald mStudio API endpoint at https://api.mittwald.de.
  • Proper configuration of the API authentication credentials in n8n is necessary.

Troubleshooting

  • Invalid or missing API credentials: Ensure the API key credential is correctly configured and has sufficient permissions.
  • Malformed roles JSON: The roles property must be valid JSON; otherwise, the request will fail. Use proper JSON formatting.
  • Expired or invalid expiration date: If provided, ensure the expiration date is in a valid format accepted by the API.
  • API errors: Check the response message from the mittwald API for details on failures, such as permission issues or rate limits.

Links and References

Discussion