Homes API

Use the homes endpoints to organize devices into homes and rooms for tenant-aware automation flows.

Base URL: https://api.hestialabs.in/v1

Endpoints

Method	Path	Summary
GET	/homes	List Homes
GET	/homes/{homeId}/rooms	List Rooms
POST	/homes	Create Home
POST	/homes/{homeId}/rooms	Create Room

List Homes

GET /homes

List all homes for the tenant

Authentication: Bearer JWT required

Parameters

None.

Responses

Status	Description
200	Home list

Example 200 response

{
  "homes": [
    "value"
  ]
}

List Rooms

GET /homes/{homeId}/rooms

List rooms in a home

Authentication: Bearer JWT required

Parameters

Name	In	Type	Required	Description
homeId	path	string	Yes	—

Responses

Status	Description
200	Room list

Create Home

POST /homes

Create a new home

Authentication: Bearer JWT required

Parameters

None.

Request body

Field	Type	Required	Description
home_name	string	Yes	—
timezone	string	No	—

Example request

{
  "home_name": "string",
  "timezone": "string"
}

Responses

Status	Description
201	Home created

Create Room

POST /homes/{homeId}/rooms

Create a room in a home

Authentication: Bearer JWT required

Parameters

Name	In	Type	Required	Description
homeId	path	string	Yes	—

Request body

Field	Type	Required	Description
name	string	Yes	—

Example request

{
  "name": "string"
}

Responses

Status	Description
201	Room created