---
title: "POST /v3/spaces_hierarchy_read/"
method: POST
path: "/v3/spaces_hierarchy_read/"
tags: ["Spaces"]
---

# POST /v3/spaces_hierarchy_read/

`POST /v3/spaces_hierarchy_read/`

SpaceHierarchyReadView operations.

## Request body

- SpaceSerializerV3
  - `id` integer
  - `name` string
  - `space_type` 'space' | 'floor' | 'building' | 'campus' | 'region' | 'portfolio'
  - `function` 'break_room' | 'cafe' | 'desk' | 'desk_neighborhood' | 'enclosed_workspace' | 'event_space' | 'games_room' | 'gym' | 'kitchen' | 'lab' | 'library' | 'lounge' | 'meeting_room' | 'open_collaboration_space' | 'open_workspace' | 'other' | 'outdoor' | 'phone_booth' | 'reception' | 'restroom' | 'retail' | 'servery' | 'theater' | 'utility_room' | 'wellness_room' | 'flex_space', nullable
  - `time_zone` string, nullable
  - `status` 'planning' | 'live'
  - `go_live_date_utc` string, date-time, nullable
  - `capacity` integer, nullable
  - `parent_id` integer, nullable
  - `address` string, nullable
  - `floor_level` integer, nullable
  - `cost_per_sqft` number, nullable
  - `size_area` number, nullable
  - `size_area_unit` 'square_feet' | 'square_meters', nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `description` string
  - `inherits_time_segments` boolean
  - `latitude` number, nullable
  - `longitude` number, nullable
  - `iwms_id` string, nullable
  - `annual_rent` number, nullable
  - `annual_rent_currency` string, nullable
  - `cost_per_sqft_currency` string, nullable
  - `daily_reset` string, nullable
  - `max_dwell_resets_enabled` boolean
  - `max_dwell_minutes` integer, nullable
  - `counting_mode` 'oa' | 'entry' | 'waffle', nullable
  - `binary_occupancy` boolean
  - `presence_debounce_true_ms` integer, nullable
  - `presence_debounce_false_ms` integer, nullable
  - `presence_debounce_enabled` boolean
  - `labels` object
  - `time_segments` object
  - `doorways` object

## Response `201`

Created

- OptionalSpaceSerializer
  - `id` integer
  - `name` string, required
  - `meta` object, nullable
  - `capacity` integer, nullable
  - `function` 'break_room' | 'cafe' | 'desk' | 'desk_neighborhood' | 'enclosed_workspace' | 'event_space' | 'games_room' | 'gym' | 'kitchen' | 'lab' | 'library' | 'lounge' | 'meeting_room' | 'open_collaboration_space' | 'open_workspace' | 'other' | 'outdoor' | 'phone_booth' | 'reception' | 'restroom' | 'retail' | 'servery' | 'theater' | 'utility_room' | 'wellness_room' | 'flex_space', nullable
  - `binary_occupancy` boolean
  - `labels` SpaceLabel[]
    - `name` string, required
    - `id` integer
  - `label_ids` integer[]
  - `locked` boolean
  - `shape` 'polygon' | 'circle'
  - `polygon_verticies` object
  - `circle_centroid_x_meters` number, nullable
  - `circle_centroid_y_meters` number, nullable
  - `circle_radius_meters` number, nullable
  - `area_id` integer
  - `counting_mode` string, nullable
  - `iwms_id` string, nullable
  - `presence_debounce_enabled` boolean
  - `presence_debounce_true_ms` integer, nullable
  - `presence_debounce_false_ms` integer, nullable

## Other responses

- `400` — Bad Request
- `403` — Forbidden

---

[API](https://skmtc.dev/density/apis/your-project-api.md) · [All operations](https://skmtc.dev/density/apis/your-project-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/density/your-project-api/revisions/eab10fe035e6/schema)