---
title: "Update camera"
method: PATCH
path: "/v1/cameras/{cameraId}"
tags: ["Cameras"]
---

# Update camera

`PATCH /v1/cameras/{cameraId}`

## Path parameters

- `cameraId` string, required

## Request body

- UpdateCameraDto
  - `name` string — Name of camera
  - `position` union[] — Position of camera
    - union
      - number
      - number
  - `rotation` number — Rotation of camera
  - `pitch` number — Camera pitch in degrees; 0 is level, positive looks down
  - `fov` number — Field of view of camera
  - `aspectRatio` '1:1' | '4:3' | '3:2' | '16:9' | '2:3' | '4:5' | '9:16' — Aspect ratio for generated renders
  - `active` boolean — Camera active status
  - `heightRelative` number
  - `llmPrompt` string, nullable
  - `inspirationImageAssetIds` string[] — Asset IDs of inspiration images attached to this camera (max 4)

## Response `200`

Camera updated successfully

- CameraApiResponseDto
  - `success` boolean, required — Indicates if the request was successful
  - `message` string, required — Human readable message
  - `data` object, required — Response data
    - `id` string, uuid, required — Camera ID
    - `level` integer, required — Level of floor the camera is on
    - `name` string, required — Name of camera
    - `heightRelative` number, required
    - `position` union[], required — Position of camera
      - union
        - number
        - number
    - `rotation` number, required — Rotation of camera
    - `pitch` number, required — Camera pitch in degrees; 0 is level, positive looks down
    - `fov` number, required — Field of view of camera
    - `aspectRatio` '1:1' | '4:3' | '3:2' | '16:9' | '2:3' | '4:5' | '9:16', required — Aspect ratio for generated renders
    - `active` boolean, required — Camera active status
    - `llmPrompt` string, nullable, required
    - `inspirationImageAssetIds` string[], required — Asset IDs of inspiration images attached to this camera (max 4)
    - `renderCount` integer, required — Number of renders for this camera
    - `createdAt` unknown, required
    - `updatedAt` unknown, required
  - `timestamp` string, date-time, required — Timestamp of the response

---

[API](https://skmtc.dev/maket/apis/virtual-architect-api.md) · [All operations](https://skmtc.dev/maket/apis/virtual-architect-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/maket/virtual-architect-api/revisions/7635e6f94477/schema)