Update a zone by ID

PUT 
/zones/:zoneId

The Update Zone request allows you to update the information of an existing zone for current Active Map in ANSCER ANYA. This request takes in the zone's unique ID as a parameter, as well as any updated zone information in the form of a JSON object. This request can be used to update a zone's name, and category, and/or geometry coordinates.

Request

Path Parameters

zoneId stringrequired

The ID of the zone to retrieve, update or delete

application/json

Body

required

name stringrequired

Possible values: >= 3 characters and <= 50 characters

A unique name of the zone

category zoneTypesrequired

Possible values: [restricted, warning, blink, buzzer, speed, no-plan]

type string

Possible values: [Feature]

GeoJSON type of the zone, always Feature

geometry object required
oneOf
GeoJSONPoint
type stringrequired
Possible values: [Point]
coordinates double[]required
GeoJSONLineString
type stringrequired
Possible values: [LineString]
coordinates array[]required
GeoJSONPolygon
type stringrequired
Possible values: [Polygon]
coordinates array[]required
properties object

Responses

200

Zone updated

application/json

Schema

Schema

_id uuid
name string

Possible values: >= 3 characters and <= 50 characters

category zoneTypes

Possible values: [restricted, warning, blink, buzzer, speed, no-plan]

isActive boolean

Default value: true

type string

Possible values: [Feature]

GeoJSON type of the zone, always Feature

geometry object
oneOf
GeoJSONPoint
type stringrequired
Possible values: [Point]
coordinates double[]required
GeoJSONLineString
type stringrequired
Possible values: [LineString]
coordinates array[]required
GeoJSONPolygon
type stringrequired
Possible values: [Polygon]
coordinates array[]required
map object

_id uuid

name string

Possible values: >= 3 characters and <= 50 characters

properties object
createdBy object
The user who created this zone
_id string
name string
email email
updatedBy object
The user who last updated this zone
_id string
name string
email email
createdAt date-time

The date and time this zone was created

updatedAt date-time

The date and time this zone was last updated

Example (from schema)

{
  "_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "category": "restricted",
  "isActive": true,
  "type": "Feature",
  "geometry": {
    "type": "Point",
    "coordinates": [
      -73.989,
      40.735
    ]
  },
  "map": {
    "_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "string"
  },
  "properties": {},
  "createdBy": {
    "_id": "string",
    "name": "string",
    "email": "user@example.com"
  },
  "updatedBy": {
    "_id": "string",
    "name": "string",
    "email": "user@example.com"
  },
  "createdAt": "2024-12-03T13:26:27.530Z",
  "updatedAt": "2024-12-03T13:26:27.530Z"
}

400

Bad Request due to validation errors in the request body

application/json

Schema

Schema

any

Example (from schema)

{
  "message": "Validation failed.",
  "errors": [
    {
      "field": "name",
      "message": "Name is required."
    }
  ]
}

Example

{
  "message": "Validation failed.",
  "errors": [
    {
      "field": "name",
      "message": "Name is required."
    }
  ]
}

401

Unauthorized.

application/json

Schema

Schema

any

Example (from schema)

{
  "message": "Authentication token not provided."
}

Example

{
  "message": "Authentication token not provided."
}

403

Forbidden.

application/json

Schema

Schema

any

Example (from schema)

{
  "message": "Access to this resource is forbidden."
}

Example

{
  "message": "Access to this resource is forbidden."
}

404

Resource not found.

application/json

Schema

Schema

any

Example (from schema)

{
  "message": "Resource not found."
}

Example

{
  "message": "Resource not found."
}

409

The Zone with given name already exists.

application/json

Schema

Schema

any

Example (from schema)

{
  "message": "The Zone with given name already exists."
}

Example

{
  "message": "The Zone with given name already exists."
}

500

Internal Server Error

application/json

Schema

Schema

any

Example (from schema)

{
  "message": "Internal Server Error. Please try again later."
}

Example

{
  "message": "Internal Server Error. Please try again later."
}

Loading...