---
title: "Exchange a viewer admission code"
method: POST
path: "/viewer-admissions"
---

# Exchange a viewer admission code

`POST /viewer-admissions`

## Request

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

## Request body

- object
  - `code` string, required
  - `origin` string, required

## Response `201`

Successful response

- object
  - `credential` string, required
  - `sessionId` string, required
  - `expiresAt` integer, required
  - `sessionCreatedAt` string, date-time, required
  - `sessionElapsedSeconds` integer, required
  - `apiKeyFingerprint` string, required
  - `viewport_mode` 'follow-human' | 'fixed', required

## Other responses

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