Create Level

2. Create Level

Op name:

scgrids.createLevel

This creates a Level object for a given Building

Endpoint:

Method: POST
Type: application/json
URL: /v1/actions

Headers:

Key	Value	Description
Authorization		(Required) The Acccess Token or HMAC Signature
x-sc-identity	external	(Required)

Query params:

Key	Value	Description
op	scgrids.createLevel	(Required) Operation Name
org		(Required) Organisation ID
pid		(Required) Project ID
propid		(Optional) Property ID

Body:

{
    "Name": "JWT Level Test 3",
    "FloorPlan": "",
    "Level": "L29"
}

More example Requests/Responses:

I. Example Request: Create Level

Body:

{
    "Name": "Level 25",
    "FloorPlan": "",
    "Level": "L25"
}

I. Example Response: Create Level

{
    "status": 201,
    "message": "Successfully created the level!",
    "data": {
        "Name": "Level 25",
        "FloorPlan": "",
        "LID": ""
    }
}

Status Code: 201

Error codes:

2. Create Level

I. Example Request: Create Level

I. Example Response: Create Level

400

Possible reasons:

1. Missing op/org/pid/propid

2. Invalid characters/improper input body

3. Missing access_token in the header

6. If the level name is already taken under the given building

7. If the given building is not found

Table of contents