---
title: "Change the supervised viewer viewport mode"
method: POST
path: "/viewer-viewport-mode"
---

# Change the supervised viewer viewport mode

`POST /viewer-viewport-mode`

## Request

- Base URL: `https://api.roveapi.com`
- URL: `https://api.roveapi.com/viewer-viewport-mode`
- Auth: none declared

## Request body

- object
  - `credential` string, required
  - `origin` string, required
  - `viewport_mode` 'follow-human' | 'fixed', required
  - `expected_generation` integer, required

## Response `200`

Successful response

- object
  - `viewport_mode` 'follow-human' | 'fixed', required
  - `transition` 'applying' | 'recovery-required' | 'returnQueued'

## Other responses

- `202`: Viewport mode operation is still applying; input remains fenced
- `401`: RFC 7807 authentication problem
- `409`: RFC 7807 state/control problem
- `410`: RFC 7807 expired or replayed admission problem

---

[API](https://skmtc.dev/roveapi/apis/rove-api.md) · [All operations](https://skmtc.dev/roveapi/apis/rove-api/llms.txt) · [OpenAPI document](https://skmtc.dev/roveapi/apis/rove-api/revisions/0e5d69bde586?raw)