POST `/mfa/credentials/{credential_id}/primary`

Set the specified MFA credential as the user's primary authentication method, while removing primary status from other credentials. Reference: OWASP ASVS V2.8.

Multi-Factor Authentication `bearerAuth` application/json

Request Parameters

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

Request Body

Schema: dto.SetPrimaryCredentialRequest

Field	Type	Required	Example	Constraints	Description
`type`	`string`	Yes

Responses

Status	Description	Schema
200	Set successfully	`dto.SetPrimaryCredentialDetailResponse`
400	Invalid parameter	`gitee_com_linmes_authms_base_dto.SimpleResponse`
401	Unauthenticated	`gitee_com_linmes_authms_base_dto.SimpleResponse`
404	Credential not found	`gitee_com_linmes_authms_base_dto.SimpleResponse`
500	Internal server error	`gitee_com_linmes_authms_base_dto.SimpleResponse`

Referenced Schemas

dto.SetPrimaryCredentialDetailResponse

Field	Type	Required
`code`	`integer`	No
`data`	`dto.SetPrimaryCredentialResponse`	No
`message`	`string`	No
`timestamp`	`string`	No

dto.SetPrimaryCredentialResponse

Field	Type	Required	Example
`credential_id`	`string`	No	`cred_abc123def456`
`primary`	`boolean`	No	`True`
`type`	`string`	No	`totp`

gitee_com_linmes_authms_base_dto.SimpleResponse

Field	Type	Required
`code`	`integer`	No
`message`	`string`	No
`timestamp`	`string`	No

Try this API in Scalar → Download OpenAPI spec (JSON) ↓

POST /mfa/credentials/{credential_id}/primary