---
title: "Verify a user"
method: POST
path: "/api/v1/users/{id}/verify-email"
tags: ["Users", "Register"]
---

# Verify a user

`POST /api/v1/users/{id}/verify-email`

Following a user registration, the new user will receive an email asking to click a link
containing a secret.
This endpoint can also be used to verify a new email set in the user account.

## Path parameters

- `id` integer, required

## Request body

- object
  - `isPendingEmail` boolean
  - `verificationString` string, url, required

## Response `204`

successful operation

## Other responses

- `403` — invalid verification string
- `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)