mittwald icon

mittwald

Interact with mittwald mStudio API

Actions100

Overview

This node operation updates an existing SSH SFTP user in the mittwald mStudio system via its API. It allows modifying various attributes of the SFTP user such as access level, active status, description, directories they can access, expiration date, password, and public keys.

Typical use cases include:

  • Changing permissions or access levels for an SFTP user.
  • Activating or deactivating an SFTP user account.
  • Updating the list of directories the user can access.
  • Setting or extending the expiration date of the user's access.
  • Rotating passwords or updating SSH public keys for security purposes.

For example, a system administrator could automate the process of disabling an SFTP user after a project ends or update their access rights when their role changes.

Properties

Name Meaning
Sftp User Id The unique identifier of the SFTP user to be updated.
Access Level The permission level granted to the user. Options: "Read" (read-only) or "Full" (full access).
Active Whether the SFTP user is active (true) or inactive (false).
Description A textual description or note about the SFTP user.
Directories JSON array defining directories accessible by the user.
Expires At Expiration date/time for the user's access in string format (e.g., ISO 8601).
Password New password for the SFTP user.
Public Keys JSON array of SSH public keys associated with the user for key-based authentication.

Output

The node outputs JSON data representing the updated SFTP user object returned from the mittwald mStudio API. This typically includes all current properties of the user after the update, such as ID, access level, active status, directories, expiration, and keys.

There is no indication that this node outputs binary data.

Dependencies

  • Requires an API key credential for authenticating with the mittwald mStudio API.
  • The node uses the base URL https://api.mittwald.de and expects JSON content-type headers.
  • No other external dependencies are indicated.

Troubleshooting

  • Invalid Sftp User Id: If the provided user ID does not exist, the API will likely return an error. Verify the ID before running the update.
  • Malformed JSON for Directories or Public Keys: Since these fields expect JSON input, ensure valid JSON syntax to avoid parsing errors.
  • Authentication Errors: Ensure the API key credential is correctly configured and has sufficient permissions.
  • Invalid Access Level: Only "read" or "full" are accepted; other values will cause errors.
  • Expired or Incorrect Date Format: The expiresAt field should be in a valid date-time string format; otherwise, the API may reject it.

Links and References

Discussion