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

# POST /locations/{locationId}/floors

`POST /locations/{locationId}/floors`

## Request

- Base URL: `https://api.cxxx.eagleeyenetworks.com/api/v3.0`
- URL: `https://api.cxxx.eagleeyenetworks.com/api/v3.0/locations/{locationId}/floors`
- Auth: HTTP bearer

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.dev/eagleeyenetworks/apis/grouping.md) - [All operations](https://skmtc.dev/eagleeyenetworks/apis/grouping/llms.txt) - [OpenAPI document](https://skmtc.dev/eagleeyenetworks/apis/grouping/revisions/ae90740cce1c?raw)