---
title: "POST /v1/cameras"
method: POST
path: "/v1/cameras"
---

# POST /v1/cameras

`POST /v1/cameras`

## Request body

- object
  - `customerId` string, uuid, required
  - `siteId` string, uuid, required
  - `externalId` string
  - `name` string, required
  - `cameraType` 'rtsp' | 'http_snapshot' | 'other', required
  - `vendor` string
  - `model` string
  - `zones` string[]
  - `metadata` object
  - `intrinsics` object, nullable
    - `fx` number, required
    - `fy` number, required
    - `cx` number, required
    - `cy` number, required
    - `k1` number
    - `k2` number
    - `p1` number
    - `p2` number
    - `k3` number
    - `imageWidth` integer, required
    - `imageHeight` integer, required
  - `intrinsicsUndistorted` object, nullable
    - `fx` number, required
    - `fy` number, required
    - `cx` number, required
    - `cy` number, required
    - `width` integer, required
    - `height` integer, required
  - `extrinsics` object, nullable
    - `rvec` unknown, required
    - `tvec` unknown, required
  - `measurementConfig` object, nullable
  - `dewarpingMode` 'fixed_views' | 'dynamic_aimed'
  - `cameraLensModel` 'pinhole' | 'fisheye_stereographic' | 'fisheye_equidistant' | 'radial', nullable
  - `rawIntrinsics` object, nullable
  - `config` object
    - `url` string, required
    - `username` string, nullable
    - `password` string, nullable
    - `bufferSeconds` number, nullable
    - `httpPollIntervalSeconds` number, nullable
    - `networkOffsetMs` union
      - integer
      - 'auto'
    - `zones` string[], nullable
    - `rtspTimestampSource` 'wall_clock' | 'rtcp_ntp' | 'camera_metadata', nullable
    - `encodingOffsetMs` integer, nullable
    - `cameraMetadataUrl` string, nullable
    - `onvifDeviceServiceUrl` string, nullable
    - `scanArea` object, nullable
    - `matchAllScans` boolean
    - `ipAddress` string, nullable

## Response `200`

Default Response

## Changes

- **2026-09-02** `c421c9d210ae` — 4 info
  - added the new optional request property `cameraLensModel`
  - added the new optional request property `config/ipAddress`
  - added the new optional request property `config/matchAllScans`
  - added the new optional request property `rawIntrinsics`
- **2026-08-28** `6c7e083dda2e` — 1 info
  - added the new optional request property `dewarpingMode`

[Change history](https://skmtc.dev/transload/apis/pipeline-backend/changes/v1/cameras/post.md)

---

[API](https://skmtc.dev/transload/apis/pipeline-backend.md) · [All operations](https://skmtc.dev/transload/apis/pipeline-backend/llms.txt) · [OpenAPI document](https://skmtc.dev/transload/apis/pipeline-backend/revisions/c5284fb49979?raw)