POST /mfa/totp/devices/{device_id}/disable

Disable a specified TOTP device by setting the Enabled status to false. Reference: RFC 6238 (TOTP), OWASP ASVS V2.8.3.

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
id	path	string	Yes				Device ID

Responses

Status	Description	Schema
200	Device Disabled	dto.TOTPDeviceItem
400	Invalid Parameters	gitee_com_linmes_authms_base_dto.SimpleResponse
401	Unauthenticated	gitee_com_linmes_authms_base_dto.SimpleResponse
404	Device Not Found	gitee_com_linmes_authms_base_dto.SimpleResponse
500	Internal Server Error	gitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

dto.TOTPDeviceItem

Field	Type	Required	Example	Constraints	Description
created_at	string	No	2026-05-12T12:00:00Z
device_id	string	No	dev-abc123
device_name	string	No	iPhone 15
enabled	boolean	No	True
last_used_at	string	No	2026-05-12T12:00:00Z
verified	boolean	No	True

gitee_com_linmes_authms_base_dto.SimpleResponse

Field	Type	Required	Example	Constraints	Description
code	integer	No
message	string	No
timestamp	string	No