PUT /api/v1/blocks/:id
Update an existing block. Nothing is returned. NOTE: A block's shape can NOT be modified once it has been created. If the wrong shape has been selected the block must be deleted and recreated.

Supported Formats

json, xml

Errors

Code Description
401 Unauthorized - ensure token is being passed with each service call.
404 Unsupported operation
500 Unspecified error on server.
422 A block's shape_id can NOT be modified.

Params

Param name Description
shape_id
required

ID for the shape of this block.

Validations:

  • Must be a Integer
dimension_1
required

Length of dimension 1 (in feet).

Validations:

  • Must be a Float
dimension_2
required

Length of dimension 2 (in feet).

Validations:

  • Must be a Float
dimension_3
optional

Length of dimension 3 (in feet). Depends on shape if required.

Validations:

  • Must be a Float
dimension_4
optional

Length of dimension 4 (in feet). Depends on shape if required.

Validations:

  • Must be a Float
dimension_5
optional

Length of dimension 5 (in feet). Depends on shape if required.

Validations:

  • Must be a Float
dimension_6
optional

Length of dimension 6 (in feet). Depends on shape if required.

Validations:

  • Must be a Float
dimension_7
optional

Length of dimension 7 (in feet). Depends on shape if required.

Validations:

  • Must be a Float
dimension_8
optional

Length of dimension 8 (in feet). Depends on shape if required.

Validations:

  • Must be a Float
number_of_floors
required

Number of floors in block (1-500).

Validations:

  • Must be a Integer
floor_to_floor_height
required

Average floor-to-floor height (in feet). Must be greater than 9.

Validations:

  • Must be a Float
floor_to_ceiling_height
required

Average floor-to-ceiling height (in feet). Must be greater than 0.

Validations:

  • Must be a Float
has_drop_ceiling
optional

True if block has a drop ceiling, false otherwise

Validations:

  • Must be one of: true, false.
orientation
required

Degrees from North of block (0-359).

Validations:

  • Must be a Float
is_above_ground
required

True if above ground, false if below ground.

Validations:

  • Must be one of: true, false.
vertices
required

x,y coordinates for the block vertices.

Validations:

  • Must be a String
position
required

x,y coordinates of block position.

Validations:

  • Must be a String
number_of_bg_floors
optional

DEPRECATED - use number_of_floors.

Validations:

  • Must be one of: .
uses_percent_served
optional

True of uses percent served, false otherwise.

Validations:

  • Must be one of: true, false.
has_timer_controls
optional

True if block has timer controls, false otherwise.

Validations:

  • Must be one of: true, false.
skylight_id
optional

ID of Skylight assigned to block.

Validations:

  • Must be a Integer
skylight_layout_id
optional

ID of Skylight layout.

Validations:

  • Must be a Integer
percent_footprint
optional

Skylight percent of roof area (usually 3%-5%).

Validations:

  • Must be a Float
roof_id
optional

ID of roof assigned to block.

Validations:

  • Must be a Integer
floor_id
optional

ID of floor assigned to block.

Validations:

  • Must be a Integer
operation_id
optional

ID of operation assigned to block.

Validations:

  • Must be a Integer
building_use_type_id
optional

ID of building use type assigned to block.

Validations:

  • Must be a Integer
perimeter_zone_depth
optional

Perimeter zone depth.

Validations:

  • Must be a Float
zone_layout_id
optional

ID of zone layout.

Validations:

  • Must be a Integer
operating_season_id
optional

ID of operating season.

Validations:

  • Must be a Integer
low_flow_faucets
optional

True of low flow faucets used, false otherwise.

Validations:

  • Must be one of: true, false.
co_sensors
optional

True if CO Sensors, false otherwise.

Validations:

  • Must be one of: true, false.