---
title: "Create an account-owned supervised viewer link"
method: POST
path: "/v1/account/supervised-sessions/{sessionId}/viewer-grants"
---

# Create an account-owned supervised viewer link

`POST /v1/account/supervised-sessions/{sessionId}/viewer-grants`

## Request

- Base URL: `https://api.roveapi.com`
- URL: `https://api.roveapi.com/v1/account/supervised-sessions/{sessionId}/viewer-grants`
- Auth: API key in cookie `rove_session`

## Path parameters

- `sessionId` string, required

## Response `201`

Successful response

- object
  - `viewer_url` string, uri, required
  - `expires_in_seconds` integer, required

## Other responses

- `401`: RFC 7807 account Lucia session required
- `403`: RFC 7807 owner mutation origin refused
- `404`: RFC 7807 session absent or outside the account
- `409`: RFC 7807 session ended or no longer eligible
- `410`: RFC 7807 expired or replayed admission problem
- `503`: RFC 7807 supervised session service unavailable

---

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