DELETE …/{user-id}/detach-role/{role-id} – API Docs

DELETE /api/v1/users/{user-id}/detach-role/{role-id}

Detach a role from a user.

Permissions

Permission	Description
`users.detach_role`	Detach a role from any user except themselves

Response

204 No Content

Despite the 204, this endpoint does return a JSON body: a localized confirmation message. HTTP defines 204 as bodyless, so some clients and proxies discard it; treat the body as informational, not something to depend on.

{
  "message": "Role detached successfully."
}

Localized from messages.users.role_detached_successfully (fa: “نقش با موفقیت حذف شد.”).

Status	Description	Reference
400	User does not have this role
401	Unauthorized	Authentication error
403	Forbidden	Permission error
404	Role or user not found	Not-found error

API DocsAPI Docs / DELETE /api/v1/users/{user-id}/detach-role/{role-id}

DELETE /api/v1/users/{user-id}/detach-role/{role-id}

Permissions

Response

204 No Content

Error Responses