VEverdun
cameras

Update Camera Zones

put/cameras/{camera_id}/zones

Request

  • Base URL
    https://api.verdun.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.verdun.ai/cameras/{camera_id}/zones
  • Auth
    HTTP bearer

Path parameters

camera_idstring required

Request body

expected_revisionstring nullable

Revision returned by GET zones (it covers the zone rows and the camera's display rotation). When supplied, replacement is atomic and returns 409 if the zones or the rotation changed. Omit only for legacy clients; a camera with a non-zero display rotation returns 409 when it is omitted.

Example request

{
  "zones": [
    {
      "name": "Street traffic",
      "points": [
        {
          "x": 12.5,
          "y": 80
        }
      ],
      "rag_context": "Public sidewalk, pedestrians expected",
      "ignore": true
    }
  ]
}

Response

Successful Response

revisionstring required

Opaque revision of the persisted zones for the next conditional replacement.

display_rotationinteger

The camera's display rotation (degrees CCW, 0 or 180) the saved zone points are expressed against: percent of the frame in the rotated (upright) space.

Example response

{
  "zones": [
    {
      "name": "Street traffic",
      "points": [
        {
          "x": 12.5,
          "y": 80
        }
      ],
      "rag_context": "Public sidewalk, pedestrians expected",
      "ignore": true
    }
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.