# Register TOTP (deprecated)

Deprecated: use POST /v1/auth/totp/register instead.  Registers a TOTP authenticator for the logged-in user. The response contains the secret and other configuration that will be used to generate TOTP codes for authentication. The app must provide it to the user (such as via QR) so the user can complete the process using their authenticator app.  Note: A TOTP authenticator is considered registered even if it wasn't added to an authenticator app.If multiple TOTPs are allowed per user per app (as configured in the authenticator settings), this API registers a new TOTP as long as the user has not reached the limit. Once the limit is reached, Mosaic will always block registration of new TOTPs.If the user is limited to single TOTP per app, attempting to register another will fail, unless your request enables override or you first revoke the authenticator that's currently registered.

Endpoint: POST /v1/users/me/totp
Security: UserAccessToken

## Request fields (application/json):

  - `device_id` (string)
    The device associated with this registration.

  - `label` (string)
    Account name displayed in the authenticator app. If unspecified, the user's email, username, or phone number will be used (ordered by preference).
    Example: "John Doe"

  - `allow_override` (boolean)
    If true, overrides the TOTP secret if one already exists

## Response 201 fields (application/json):

  - `secret` (string, required)
    The secret key used to generate the TOTP code. It can be provided to the user to enter manually into the authenticator app.

  - `uri` (string, required)
    A URI containing the secret and other configuration used to generate the TOTP code. It can be encoded in a QR code for the user to scan using their authenticator app