/cameras

post

https://{BaseUrl}/api/v3.0/cameras

Associates a camera with the account. This can only be called with an end-user account, and will result in an error if tried with any other type of account.

Body Params

name

string

required

length between 1 and 126

User-defined name for the device.

tags

locationId

string | null

ID Of the location.

devicePosition

object

deviceAddress

object

Address of the device.

bridgeId

string

required

The bridge a camera is connected to. Keep in mind that some cameras are connected directly to the cloud, which is when this field will not be reported.

credentials

object

guid

uuid | null

required

registrationStrategy

string

enum

required

Cameras can be added in multiple ways, and this field indicates how this specific camera should be added. Possible methods:

bridge: Associate a camera found with GET /api/v3.0/availableDevices with one of the bridges that found it.
rtspUrl: Define a camera by giving a RTSP URL to retrieve its live stream and the bridge that should connect to it.
cameraDirect: Register a camera by its MAC address regardless of its physical location and without needing a bridge.
channel: Associate a channel camera with its parent multi camera.

Allowed:

Responses

201Camera added

400The supplied object is invalid. Error detail will contain the validation error.

401You are not authenticated. Please authenticate and try again.

403You have no permission to access the specified resource.

404Referenced resource could not be found.

409There was a conflict while trying to perform your request.

500The request encountered an internal error.

504The request had a deadline that expired before the operation completed.