Remove

[POST] .../v1/userdashboard/remove

Removes a dashboard assignment from a user. Use this destructive method to remove a dashboard from a user's assigned dashboard list. The method checks the user-dashboard remove permission, resolves user_id from the request or current request context when user_id is omitted or 0, validates the user and assignment, rejects the default dashboard assignment and deletes the user-dashboard link; when the selected user is the dashboard creator, the linked dashboard is also soft-deleted and affected users are moved back to the system default dashboard. The request body is required and dashboard_id must be positive, while user_id may be 0 to target the current request user. Business errors such as missing body, invalid dashboard_id, denied permission, missing current user context, missing user or assignment, default-dashboard deletion, database errors, transaction failures, no affected rows and action-log failures are returned as HTTP 200 ErrorResult.

Request Parameters

Name Type Required Description
dashboard_id Int64 Required Dashboard ID.
user_id Int64 Optional User ID. If omitted or 0, the current request user is used.

Request Example

{
  "user_id": 0,
  "dashboard_id": 3
}

Response Parameters

Name Type Description
ok Boolean Indicates whether the request completed successfully.
result Update Update operation result.

Response Example

{
  "ok": true,
  "result": {
    "row_affected": 1,
    "ids": []
  }
}