---
title: "Patch live view configuration"
method: PATCH
path: "/v1/liveviews/{id}"
tags: ["Live view management"]
---

# Patch live view configuration

`PATCH /v1/liveviews/{id}`

## Request

- Base URL: `https://api.ui.com/v1/connector/consoles/942A6FF664C0000000000964970E0000000009E710560000000068A9873F:9999999999/proxy/protect/integration`
- URL: `https://api.ui.com/v1/connector/consoles/942A6FF664C0000000000964970E0000000009E710560000000068A9873F:9999999999/proxy/protect/integration/v1/liveviews/{id}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/ubiquiti/apis/unifi-protect-api/docs/v1/liveviews/:id/patch.ts> (a function with typed inputs; its response is checked against the schema)

Patch the configuration about a specific live view

## Path parameters

- `id` string, required: The primary key of liveview

## Request body

- Liveview
  - `id` string, required: The primary key of liveview
  - `modelKey` 'liveview', required: The model key of the liveview
  - `name` string, required: The name of this live view.
  - `isDefault` boolean, required: Whether this live view is the default one for all viewers.
  - `isGlobal` boolean, required: Whether this live view is global and available system-wide to all users
  - `owner` string, required: The primary key of user
  - `layout` number, required: The number of slots this live view contains. Which as a consequence also affects the layout of the live view.
  - `slots` object[], required: List of cameras visible in each given slot. And cycling settings for each slot if it has multiple cameras listed.
    - `cameras` CameraId[], required
    - `cycleMode` 'motion' | 'time', required: Whether to switch to next camera in slot based on motion events or a strict time interval
    - `cycleInterval` number, required: How long should each camera stream be shown for in seconds until we cycle to the next camera

## Response `200`

Success response

- Liveview
  - `id` string, required: The primary key of liveview
  - `modelKey` 'liveview', required: The model key of the liveview
  - `name` string, required: The name of this live view.
  - `isDefault` boolean, required: Whether this live view is the default one for all viewers.
  - `isGlobal` boolean, required: Whether this live view is global and available system-wide to all users
  - `owner` string, required: The primary key of user
  - `layout` number, required: The number of slots this live view contains. Which as a consequence also affects the layout of the live view.
  - `slots` object[], required: List of cameras visible in each given slot. And cycling settings for each slot if it has multiple cameras listed.
    - `cameras` CameraId[], required
    - `cycleMode` 'motion' | 'time', required: Whether to switch to next camera in slot based on motion events or a strict time interval
    - `cycleInterval` number, required: How long should each camera stream be shown for in seconds until we cycle to the next camera

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/ubiquiti/apis/unifi-protect-api.md) - [All operations](https://skmtc.dev/ubiquiti/apis/unifi-protect-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ubiquiti/apis/unifi-protect-api/revisions/e341e1381db1?raw)