---
title: "Create a new liveness session with verify. Provide the verify image during session creation."
method: POST
path: "/detectLivenessWithVerify/singleModal/sessions"
---

# Create a new liveness session with verify. Provide the verify image during session creation.

`POST /detectLivenessWithVerify/singleModal/sessions`

A session is best for client device scenarios where developers want to authorize a client device to perform only a liveness detection without granting full access to their resource. Created sessions have a limited life span and only authorize clients to perform the desired action before access is expired.

Permissions includes...
>
*
  * A token lifetime of 10 minutes.

> [!NOTE]
>
> *
>   * Client access can be revoked by deleting the session using the Delete Liveness With Verify Session operation.
>   * To retrieve a result, use the Get Liveness With Verify Session.
>   * To audit the individual requests that a client has made to your resource, use the List Liveness With Verify Session Audit Entries.

Recommended Option: VerifyImage is provided during session creation.

## Response `200`

A successful call create a session for a client device and provide an authorization token for use by the client application for a limited purpose and time.

- CreateLivenessWithVerifySessionResult — Response of liveness session with verify creation with verify image provided.
  - `sessionId` string, required — The unique session ID of the created session. It will expire 48 hours after it was created or may be deleted sooner using the corresponding Session DELETE operation.
  - `authToken` string, required — Bearer token to provide authentication for the Vision SDK running on a client application. This Bearer token has limited permissions to perform only the required action and expires after the TTL time. It is also auditable.
  - `verifyImage` LivenessWithVerifyImage — The detail of face for verification.
    - `faceRectangle` FaceRectangle, required — A rectangle within which a face can be found.
      - `top` integer, required — The distance from the top edge if the image to the top edge of the rectangle, in pixels.
      - `left` integer, required — The distance from the left edge if the image to the left edge of the rectangle, in pixels.
      - `width` integer, required — The width of the rectangle, in pixels.
      - `height` integer, required — The height of the rectangle, in pixels.
    - `qualityForRecognition` 'low' | 'medium' | 'high', required — Indicates quality of image for recognition.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** `44e2cf82becd` — 1 info
  - endpoint added
- **2026-07-13** `e1f63ec9983b` — 1 info
  - endpoint added
- **2026-07-13** `5375faa8d134` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/azure/apis/ai-face/changes/detectLivenessWithVerify/singleModal/sessions/post.md)

---

[API](https://skmtc.dev/azure/apis/ai-face.md) · [All operations](https://skmtc.dev/azure/apis/ai-face/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/ai-face/revisions/44e2cf82becd/schema)