---
title: "Create a camera view"
method: POST
path: "/v3/backoffice/camera-view"
tags: ["Camera view"]
---

# Create a camera view

`POST /v3/backoffice/camera-view`

## Request

- Base URL: `https://api.rhinoartisan.com`
- URL: `https://api.rhinoartisan.com/v3/backoffice/camera-view`
- Auth: API key in header `apikey`
- TypeScript: <https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/docs/v3/backoffice/camera-view/post.ts> (a function with typed inputs; its response is checked against the schema)

JSON: `name`, `azimuth` and `polar` (radians, as the viewer orbit gives them), optionally `framing` (distance relative to fitting the piece, 1 = exact) and `role` (main, top, side or null).

## Request body

- object
  - `name` string
  - `azimuth` number
  - `polar` number
  - `framing` number
  - `role` 'main' | 'top' | 'side', nullable

## Response `201`

Camera view created

## Other responses

- `400`: INVALID_CAMERA_VIEW, INVALID_CAMERA_VIEW_NAME, INVALID_CAMERA_VIEW_ROLE, TOO_MANY_CAMERA_VIEWS

## Changes

- **2026-10-15** `598bac108453`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/changes/v3/backoffice/camera-view/post.md)

---

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