Matchai Docs

Rename or resize a roomComing soon

Changes a room’s name, floor, size, flooring or note. Leave out dimension_unit to keep the room’s unit.

Coming soon. This is documented ahead of launch so you can plan your integration; it is not available yet.
PATCH
/listings/{listing_id}/spaces/{space_id}

Coming soon. Changes a room’s name, floor, size, flooring or note. Leave out dimension_unit to keep the room’s unit.

Scopes: listings:write

Pricing: Included with the connection.

Authorization

headerAuthorizationBearer <matchai_<base62>>

A personal API key, sent as Authorization: Bearer matchai_…. Create keys in Matchai under Settings → Connectors → Advanced (for developers). A key starts with matchai_ followed by letters and digits, carries the scopes chosen when it was created, and can be revoked at any time. Keys reach only the account that created them: to serve other professionals, use Connect with Matchai.

Scope: listings:write

Path Parameters

listing_id*string

Listing id, or its slug.

Length1 <= length <= 200
space_id*string

Space id.

Length1 <= length <= 64

Request Body

application/json
  1. body
Properties1 <= properties
name?string

Name.

Length1 <= length <= 120
floor_level?string

Storey.

Length1 <= length <= 40
width?number

Width.

Range0.5 <= value <= 500
depth?number

Depth.

Range0.5 <= value <= 500
dimension_unit?DimensionUnit
Value in"feet""meters"
flooring?|

Floor covering.

Lengthlength <= 60
notes?|

Note.

Lengthlength <= 500

Response Body

The room.

application/json
  1. response

A room or space of the property.

id*string

Space id.

Length1 <= length <= 64
listing_id*string

Listing id.

Length1 <= length <= 64
type*string

A space type key from GET /space-types, for example bedroom.

name?|

Name, for example "Primary bedroom".

floor_level?|

Storey, for example "Ground" or "2nd".

width?|

Width, in dimension_unit.

depth?|

Depth, in dimension_unit.

dimension_unit?|null
flooring?|

Floor covering, for example "Hardwood".

notes?|

Short note about the room.

position*integer

Order on the listing page.

Range0 <= value
Example Request
curl -X PATCH 'https://api.matchai.co/v1/listings/string/spaces/string' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "id": "string",  "listing_id": "string",  "type": "string",  "name": "string",  "floor_level": "string",  "width": 0,  "depth": 0,  "dimension_unit": "feet",  "flooring": "string",  "notes": "string",  "position": 0}