---
title: "Create auth token from user face"
method: POST
path: "/auth/video-auth/"
tags: ["auth"]
---

# Create auth token from user face

`POST /auth/video-auth/`

Use this operation to obtain an authorization token which could be used in all other operations.

To use this handler, send a video file that shows the face of the user being logged in.

This method returns a structure containing authorization `token`.

Copy its value, prepend it with "Token" and paste the entire thing into the **API Key** field
in the authorization form of this documentation viewer.

If the system uses face and password authentication, save the token received during face authentication 
(it will be inactive until the correct password is entered) and pass it 
along with basic authorization to the `/auth/login/` handler.

## Response `200`

- LoginResult
  - `token` string, required — Authorization token
  - `user` User, required
    - `id` integer, required
    - `active` boolean, required
    - `created_date` string, date-time, required
    - `groups` integer[]
    - `modified_date` string, date-time, required — Object modification date
    - `permissions` string[], required
    - `real_name` string, required
    - `name` string, required
    - `comment` string — Extended description of the user, up to 2048 chars
    - `camera_group_permissions` object, required
    - `watch_list_permissions` object, required
    - `group_permissions` object, required
    - `primary_group` integer, required
    - `language` 'en-us' | 'es' | 'ru'
    - `has_face` boolean, required — User photo is provided
    - `face_cover` string, nullable
    - `ad_user` boolean, required — User is registered in Active Directory
  - `token_expiration_datetime` string, date-time, required — Token expiration datetime

## Other responses

- `401`

---

[API](https://skmtc.dev/ntechlab/apis/internal-api-documentation.md) · [All operations](https://skmtc.dev/ntechlab/apis/internal-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ntechlab/internal-api-documentation/revisions/fe217a895bc7/schema)