---
title: "POST /locations/{locationId}/floors"
method: POST
path: "/locations/{locationId}/floors"
tags: ["Floors"]
---

# POST /locations/{locationId}/floors

`POST /locations/{locationId}/floors`

This endpoint allows you to create a floor. Support for Location-based camera grouping is only available in the professional and enterprise editions.

## Request body

- FloorCreatePayload — Represents a floor of a location
  - `id` string — Unique identifier of the floor
  - `name` string, required
  - `floorLevel` integer, required — The floor level in a multi-storey building
  - `topLeftCoordinates` PointPosition, required
    - `latitude` number, double, required — The latitude of the device. (WGS 84)
    - `longitude` number, double, required — The longitude of the device. (WGS 84).
  - `bottomRightCoordinates` PointPosition, required
    - `latitude` number, double, required — The latitude of the device. (WGS 84)
    - `longitude` number, double, required — The longitude of the device. (WGS 84).
  - `floorPlans` FloorPlanGetResponse[]
    - `id` string — Unique identifier of the floor plan
    - `floorId` string — Unique identifier of the floor
    - `type` 'png' | 'svg' | 'pdf' — Type of the floor image
    - `creator` 'originalUpload' | 'cloudGenerated'

## Response `201`

Floor created

- BasicFloorResponse — Represents a floor of a location
  - `id` string, required — Unique identifier of the floor
  - `name` string, required
  - `floorLevel` integer, required — The floor level in a multi-storey building
  - `topLeftCoordinates` PointPosition, required
    - `latitude` number, double, required — The latitude of the device. (WGS 84)
    - `longitude` number, double, required — The longitude of the device. (WGS 84).
  - `bottomRightCoordinates` PointPosition, required
    - `latitude` number, double, required — The latitude of the device. (WGS 84)
    - `longitude` number, double, required — The longitude of the device. (WGS 84).

## Other responses

- `400` — The supplied object is invalid. Error detail will contain the validation error.
- `401` — You are not authenticated. Please authenticate and try again.
- `403` — You have no permission to access the specified resource.
- `404` — Referenced resource could not be found.
- `409` — There was a conflict while trying to perform your request. See error details for more information.
- `500` — Something went wrong in the server. Please try again.

---

[API](https://skmtc.net/eagleeyenetworks/apis/devices.md) · [All operations](https://skmtc.net/eagleeyenetworks/apis/devices/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eagleeyenetworks/devices/versions/df57313de545/schema)