---
title: "Notify user is watching a video"
method: POST
path: "/api/v1/videos/{id}/views"
tags: ["Video"]
---

# Notify user is watching a video

`POST /api/v1/videos/{id}/views`

Call this endpoint regularly (every 5-10 seconds for example) to notify the server the user is watching the video. After a while, PeerTube will increase video's viewers counter. If the user is authenticated, PeerTube will also store the current player time.

## Path parameters

- `id` union, required
  - integer
  - string, uuid
  - string — translation of a uuid v4 with a bigger alphabet to have a shorter uuid

## Request body

- UserViewingVideo
  - `currentTime` integer, required — timestamp within the video, in seconds
  - `viewEvent` 'seek' — Event since last viewing call: * `seek` - If the user seeked the video

## Response `204`

successful operation

---

[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)