---
title: "Request two factor auth"
method: POST
path: "/api/v1/users/{id}/two-factor/request"
tags: ["Users"]
---

# Request two factor auth

`POST /api/v1/users/{id}/two-factor/request`

Request two factor authentication for a user

## Path parameters

- `id` integer, required

## Request body

- object
  - `currentPassword` string — Password of the currently authenticated user

## Response `200`

successful operation

- RequestTwoFactorResponse[]
  - `otpRequest` object
    - `requestToken` string — The token to send to confirm this request
    - `secret` string — The OTP secret
    - `uri` string — The OTP URI

## Other responses

- `403` — invalid password
- `404` — user not found

---

[API](https://skmtc.net/cpy/apis/peertube.md) · [All operations](https://skmtc.net/cpy/apis/peertube/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cpy/peertube/versions/efe11b159e43/schema)