Mira Admin Delete icon

Mira Admin Delete

Delete administrator from Mira App Server (soft delete)

Mira Admin Delete

AI-generated

Overview

The "Mira Admin Delete" node is designed to perform a soft delete of an administrator account on the Mira App Server. It sends a DELETE request to the server's API endpoint for administrators, targeting a specific admin by their ID. This node is useful in scenarios where you need to deactivate or remove administrative users from the Mira system without permanently erasing their data, allowing for potential recovery or auditing.

Practical examples:

  • Automatically deactivating admin accounts when they leave an organization.
  • Cleaning up test or temporary admin users created during development.
  • Integrating with HR systems to synchronize admin access based on employment status.

Properties

Name Meaning
Token Source Choose where to get the access token from: either from stored credentials or from input data.
Server URL The URL of the Mira App Server (required if token source is from input).
Access Token The access token used for authentication, can be provided directly or via input data.
Admin ID The unique identifier of the administrator to be soft deleted. Supports expressions like {{ $json.id }}.
⚠️ Warning: This will soft delete the administrator account A notice warning that this operation performs a soft delete rather than a permanent removal.

Output

The node outputs JSON data representing the response from the Mira App Server after attempting to soft delete the specified administrator. The output includes confirmation details enhanced by the helper function to indicate the soft deletion status of the admin account.

No binary data is produced by this node.

Dependencies

  • Requires access to the Mira App Server API.
  • Needs an access token for authentication, which can be supplied either through stored credentials or dynamically via input data.
  • The node depends on shared Mira helper modules for HTTP requests and response processing.

Troubleshooting

  • Missing or invalid Admin ID: The node requires a valid administrator ID; ensure this is correctly provided and not empty.
  • Authentication errors: If the access token is missing, expired, or incorrect, the API call will fail. Verify token validity and source configuration.
  • Server connectivity issues: Confirm the Server URL is reachable and correct, especially if using a custom URL.
  • API permission errors: The token used must have sufficient permissions to delete administrators; otherwise, the request will be denied.
  • Soft delete misunderstanding: Users might expect a permanent delete; clarify that this operation only soft deletes the admin account.

Links and References

  • Mira App Server API documentation (refer to the admins management section)
  • n8n documentation on creating and using credentials and tokens
  • General REST API best practices for DELETE operations

Discussion