Download OpenAPI specification:Download
The SightMap® API uses standard HTTP verbs to communicate and HTTP status codes to indicate status and errors. All responses come in standard JSON. The SightMap API is served over HTTPS to ensure data privacy; HTTP is not supported.
Versions are communicated as VERSION.RELEASE-DATE
, where VERSION
denotes
the version number of the API and prefixed to all API request paths, such as
/v1/assets
. RELEASE-DATE
denotes backwards-compatible changes to the
API.
When any non-backwards compatible additions must be made to the API, the version number will be incremented.
We consider the following changes to be backwards-compatible:
VARCHAR(255) COLLATE utf8_bin
column (the COLLATE
configuration ensures
case-sensitivity in lookups).For requests which require Authentication, an API Key can be provided by
either the api-key
query parameter or API-Key
header. We recommend the
header over the query parameter as it avoids your API key from being stored
in browser history and most server logs. If neither query parameter or
header is provided, a 401
status code is returned with the following JSON:
{
"message": "No API key found in request"
}
If your API key cannot be validated, a 403
status code is returned with
the following JSON:
{
"message": "Invalid authentication credentials"
}
We provide new API features via experimental flags. This allows users to opt-in for new functionality and provide feedback prior to a feature becoming generally available (GA). We believe in stability without stagnation. This ability allows our team to build and ship best-in-class APIs faster while upholding backwards-compatibility on GA features.
Experimental features are subject to change while undergoing development and feedback. Therefore, they are exempt from any backwards-compatibility guarantees until they reach GA. We do not expect nor recommend using experimental features in production environments unless a partnership has been established with our teams working closely together.
Flags are provided via the Experimental-Flags
header. A comma-separated list
is expected in order to pass multiple flags on a single request.
curl -i https://api.sightmap.com/v1/assets \
-H "API-Key: 12345" \
-H "Experimental-Flags: flag-1,flag-2"
The SightMap API uses standard HTTP status codes to indicate the success or failure of the API request. The body of the response will be JSON in the following format:
{
"message": "Not found"
}
Returns a list of accounts.
page | integer <int32> Request a specific page of resources. |
per-page | integer <int32> Limit the number of returned resources. |
{- "paging": {
- "per_page": 100,
- "current_page": 1,
- "prev_url": null,
- "next_url": null
}, - "data": [
- {
- "id": "95",
- "name": "Engrain",
- "created_at": "2017-09-11T17:09:18+00:00",
- "updated_at": "2017-09-11T17:09:18+00:00"
}
]
}
Returns a specific account.
account required | string <id> <= 255 characters An account ID. |
{- "id": "95",
- "name": "Engrain",
- "created_at": "2017-09-11T17:09:18+00:00",
- "updated_at": "2017-09-11T17:09:18+00:00"
}
Returns a list of embeds for an account.
Requires sightmap.embeds.read
permission.
NOTICE: This resource is experimental and requires the embed-resource
experimental flag.
account required | string <id> <= 255 characters An account ID. |
page | integer <int32> Request a specific page of resources. |
per-page | integer <int32> Limit the number of returned resources. |
asset | string <id> <= 255 characters An asset ID to filter the list on. |
Experimental-Flags required | string This resource is experimental and requires the |
{- "paging": {
- "per_page": 100,
- "current_page": 1,
- "prev_url": null,
- "next_url": null
}, - "data": [
- {
- "id": "5587",
- "account_id": "95",
- "name": "The Lofts at New Main",
- "sightmaps": [
- {
- "id": "10486",
- "asset_id": "1323",
- "instance_key": null
}
], - "created_at": "2020-10-30T15:16:35+00:00",
- "updated_at": "2020-11-04T23:45:31+00:00"
}
]
}
Returns a specific embed.
Requires sightmap.embeds.read
permission.
NOTICE: This resource is experimental and requires the
embed-resource
experimental flag.
account required | string <id> <= 255 characters An account ID. |
embed required | string <id> <= 255 characters An embed ID. |
Experimental-Flags required | string This resource is experimental and requires the |
{- "id": "5587",
- "account_id": "95",
- "name": "The Lofts at New Main",
- "sightmaps": [
- {
- "id": "10486",
- "asset_id": "1323",
- "instance_key": null
}
], - "created_at": "2020-10-30T15:16:35+00:00",
- "updated_at": "2020-11-04T23:45:31+00:00"
}
Returns a list of allowed assets on an account.
NOTICE: This resource is experimental and requires the accounts-assets
experimental flag.
account required | string <id> <= 255 characters An account ID. |
page | integer <int32> Request a specific page of resources. |
per-page | integer <int32> Limit the number of returned resources. |
asset | string <id> <= 255 characters An asset ID to filter the list on. |
Experimental-Flags required | string This resource is experimental and requires the |
{- "paging": {
- "per_page": 100,
- "current_page": 1,
- "prev_url": null,
- "next_url": null
}, - "data": [
- {
- "id": "1323",
- "uuid": "d5779fbb-43fe-4d54-b642-266ce815a3f3",
- "market": "multifamily",
- "name": "The Lofts at New Main",
- "display_name": "The Lofts at New Main",
- "description": null,
- "unit_count": 138,
- "address_line1": "100 New Main St",
- "address_line2": null,
- "address_city": "Cleveland",
- "address_state": "OH",
- "address_country": "USA",
- "address_postal_code": "91801",
- "address_latitude": 41.433243,
- "address_longitude": -81.3941872,
- "created_at": "2017-09-11T17:08:59+00:00",
- "updated_at": "2019-10-10T04:25:58+00:00"
}
]
}
Assign one or more assets to an account.
Requires sightmap.accounts.update-assets
permission.
NOTICE: This resource is experimental and requires the
accounts-assets
experimental flag.
account required | string <id> <= 255 characters An account ID. |
required | Array of objects | ||||
Array
|
{- "data": [
- {
- "account_id": "1",
- "asset_id": "1"
}, - {
- "account_id": "1",
- "asset_id": "2"
}, - {
- "account_id": "1",
- "asset_id": "3"
}
]
}
{- "message": "No API key found in request"
}
Unassign one or more assets from an account.
Requires sightmap.accounts.update-assets
permission.
NOTICE: This resource is experimental and requires the
accounts-assets
experimental flag.
WARNING: When an asset is unassigned from an account, any embeds or other related data may be deleted and cannot be undone.
account required | string <id> <= 255 characters An account ID. |
required | Array of objects | ||||
Array
|
{- "data": [
- {
- "account_id": "1",
- "asset_id": "1"
}, - {
- "account_id": "1",
- "asset_id": "2"
}
]
}
{- "message": "No API key found in request"
}
Returns a list of allowed assets.
page | integer <int32> Request a specific page of resources. |
per-page | integer <int32> Limit the number of returned resources. |
{- "paging": {
- "per_page": 100,
- "current_page": 1,
- "prev_url": null,
- "next_url": null
}, - "data": [
- {
- "id": "1323",
- "uuid": "d5779fbb-43fe-4d54-b642-266ce815a3f3",
- "market": "multifamily",
- "name": "The Lofts at New Main",
- "display_name": "The Lofts at New Main",
- "description": null,
- "unit_count": 138,
- "address_line1": "100 New Main St",
- "address_line2": null,
- "address_city": "Cleveland",
- "address_state": "OH",
- "address_country": "USA",
- "address_postal_code": "91801",
- "address_latitude": 41.433243,
- "address_longitude": -81.3941872,
- "created_at": "2017-09-11T17:08:59+00:00",
- "updated_at": "2019-10-10T04:25:58+00:00"
}
]
}
Requires sightmap.assets.create
permission
market required | string Enum: "affordable_housing" "agriculture" "airplane" "airport" "build_to_rent" "camping" "cemetery" "condos" "coworking" "cruise_ship" "cultural" "data_center" "demo" "education" "entertainment" "gallery_museum" "geography" "government" "harbor_marina" "healthcare" "hospitality" "industrial" "infrastructure" "land" "logistics" "manufactured_housing" "master_planned" "military_housing" "mixed_use" "multifamily" "office" "oil_and_gas" "other" "parking" "rentable_items" "resort" "retail" "salon" "self_storage" "senior_living" "single_family" "spa" "stadium_arena" "student" "theme_park" "transit" |
name required | string <= 255 characters |
display_name required | string <= 255 characters |
description | string or null <= 255 characters |
address_line1 required | string <= 63 characters |
address_line2 | string or null <= 63 characters |
address_city required | string <= 63 characters |
address_state required | string = 2 characters Two letter abbreviated state or province. |
address_country required | string = 3 characters An ISO 3166-1 alpha-3 country code. |
address_postal_code required | string <= 15 characters |
address_latitude | number or null <float> [ -90 .. 90 ] |
address_longitude | number or null <float> [ -180 .. 180 ] |
{- "market": "multifamily",
- "name": "The Lofts at New Main",
- "display_name": "The Lofts at New Main",
- "description": null,
- "address_line1": "100 New Main St",
- "address_line2": null,
- "address_city": "Cleveland",
- "address_state": "OH",
- "address_country": "USA",
- "address_postal_code": "91801",
- "address_latitude": 41.433243,
- "address_longitude": -81.3941872
}
{- "id": "1323",
- "uuid": "d5779fbb-43fe-4d54-b642-266ce815a3f3",
- "market": "multifamily",
- "name": "The Lofts at New Main",
- "display_name": "The Lofts at New Main",
- "description": null,
- "unit_count": 138,
- "address_line1": "100 New Main St",
- "address_line2": null,
- "address_city": "Cleveland",
- "address_state": "OH",
- "address_country": "USA",
- "address_postal_code": "91801",
- "address_latitude": 41.433243,
- "address_longitude": -81.3941872,
- "created_at": "2017-09-11T17:08:59+00:00",
- "updated_at": "2019-10-10T04:25:58+00:00"
}
asset required | string <id> <= 255 characters An asset ID. |
{- "id": "1323",
- "uuid": "d5779fbb-43fe-4d54-b642-266ce815a3f3",
- "market": "multifamily",
- "name": "The Lofts at New Main",
- "display_name": "The Lofts at New Main",
- "description": null,
- "unit_count": 138,
- "address_line1": "100 New Main St",
- "address_line2": null,
- "address_city": "Cleveland",
- "address_state": "OH",
- "address_country": "USA",
- "address_postal_code": "91801",
- "address_latitude": 41.433243,
- "address_longitude": -81.3941872,
- "created_at": "2017-09-11T17:08:59+00:00",
- "updated_at": "2019-10-10T04:25:58+00:00"
}
Requires sightmap.assets.update
permission
asset required | string <id> <= 255 characters An asset ID. |
id required | string <id> <= 255 characters |
market | string Enum: "affordable_housing" "agriculture" "airplane" "airport" "build_to_rent" "camping" "cemetery" "condos" "coworking" "cruise_ship" "cultural" "data_center" "demo" "education" "entertainment" "gallery_museum" "geography" "government" "harbor_marina" "healthcare" "hospitality" "industrial" "infrastructure" "land" "logistics" "manufactured_housing" "master_planned" "military_housing" "mixed_use" "multifamily" "office" "oil_and_gas" "other" "parking" "rentable_items" "resort" "retail" "salon" "self_storage" "senior_living" "single_family" "spa" "stadium_arena" "student" "theme_park" "transit" |
name | string <= 255 characters |
display_name | string <= 255 characters |
description | string or null <= 255 characters |
address_line1 | string <= 63 characters |
address_line2 | string or null <= 63 characters |
address_city | string <= 63 characters |
address_state | string = 2 characters Two letter abbreviated state or province. |
address_country | string = 3 characters An ISO 3166-1 alpha-3 country code. |
address_postal_code | string <= 15 characters |
address_latitude | number or null <float> [ -90 .. 90 ] |
address_longitude | number or null <float> [ -180 .. 180 ] |
{- "id": "1323",
- "market": "multifamily",
- "name": "The Lofts at New Main",
- "display_name": "The Lofts at New Main",
- "address_line1": "100 New Main St",
- "address_city": "Cleveland",
- "address_state": "OH",
- "address_country": "USA",
- "address_postal_code": "91801",
- "address_latitude": 41.433243,
- "address_longitude": -81.3941872
}
{- "id": "1323",
- "uuid": "d5779fbb-43fe-4d54-b642-266ce815a3f3",
- "market": "multifamily",
- "name": "The Lofts at New Main",
- "display_name": "The Lofts at New Main",
- "description": null,
- "unit_count": 138,
- "address_line1": "100 New Main St",
- "address_line2": null,
- "address_city": "Cleveland",
- "address_state": "OH",
- "address_country": "USA",
- "address_postal_code": "91801",
- "address_latitude": 41.433243,
- "address_longitude": -81.3941872,
- "created_at": "2017-09-11T17:08:59+00:00",
- "updated_at": "2019-10-10T04:25:58+00:00"
}
Returns a list of units for an asset.
Requires sightmap.units.read
permission.
asset required | string <id> <= 255 characters An asset ID. |
page | integer <int32> Request a specific page of resources. |
per-page | integer <int32> Limit the number of returned resources. |
unit-number | string <= 255 characters A unit number to filter the list on. |
{- "paging": {
- "per_page": 100,
- "current_page": 1,
- "prev_url": null,
- "next_url": null
}, - "data": [
- {
- "id": "258670",
- "asset_id": "1323",
- "building_id": "8265",
- "floor_id": "4730",
- "floor_plan_id": "14641",
- "map_id": "258670",
- "unit_number": "E13",
- "area": 700,
- "view_image_url": null,
- "secondary_view_image_url": null,
- "created_at": "2017-09-11T17:09:18+00:00",
- "updated_at": "2018-01-20T03:44:39+00:00"
}
]
}
Create a unit for an asset.
Requires sightmap.units.create
permission.
asset required | string <id> <= 255 characters An asset ID. |
asset_id required | string <id> <= 255 characters The asset the unit belongs to. |
building_id required | string <id> <= 255 characters The building the unit is in. |
floor_id required | string <id> <= 255 characters The floor the unit is on. |
floor_plan_id required | string <id> <= 255 characters The floor plan of the unit. |
unit_number required | string <= 255 characters The unit number. |
area required | integer <int32> >= 0 The area of the unit represented as square footage or square meters. |
{- "asset_id": "1323",
- "building_id": "8265",
- "floor_id": "4730",
- "floor_plan_id": "14641",
- "unit_number": "E13",
- "area": 700
}
{- "id": "258670",
- "asset_id": "1323",
- "building_id": "8265",
- "floor_id": "4730",
- "floor_plan_id": "14641",
- "map_id": "258670",
- "unit_number": "E13",
- "area": 700,
- "view_image_url": null,
- "secondary_view_image_url": null,
- "created_at": "2017-09-11T17:09:18+00:00",
- "updated_at": "2018-01-20T03:44:39+00:00"
}
Returns a specific unit.
Requires sightmap.units.read
permission.
asset required | string <id> <= 255 characters An asset ID. |
unit required | string <id> <= 255 characters A unit ID. |
{- "id": "258670",
- "asset_id": "1323",
- "building_id": "8265",
- "floor_id": "4730",
- "floor_plan_id": "14641",
- "map_id": "258670",
- "unit_number": "E13",
- "area": 700,
- "view_image_url": null,
- "secondary_view_image_url": null,
- "created_at": "2017-09-11T17:09:18+00:00",
- "updated_at": "2018-01-20T03:44:39+00:00"
}
Requires sightmap.units.update
permission.
asset required | string <id> <= 255 characters An asset ID. |
unit required | string <id> <= 255 characters A unit ID. |
id required | string <id> <= 255 characters |
asset_id required | string <id> <= 255 characters The asset the unit belongs to. |
building_id | string <id> <= 255 characters The building the unit is in. |
floor_id | string <id> <= 255 characters The floor the unit is on. |
floor_plan_id | string <id> <= 255 characters The floor plan of the unit. |
unit_number | string <= 255 characters The unit number. |
area | integer <int32> >= 0 The area of the unit represented as square footage or square meters. |
view_image | string Value: "delete" Delete the primary view image of the unit. |
secondary_view_image | string Value: "delete" Delete the secondary view image of the unit. |
{- "id": "258670",
- "asset_id": "1323",
- "building_id": "8265",
- "floor_id": "4730",
- "floor_plan_id": "14641",
- "map_id": "258670",
- "unit_number": "E13",
- "area": 700
}
{- "id": "258670",
- "asset_id": "1323",
- "building_id": "8265",
- "floor_id": "4730",
- "floor_plan_id": "14641",
- "map_id": "258670",
- "unit_number": "E13",
- "area": 700,
- "view_image_url": null,
- "secondary_view_image_url": null,
- "created_at": "2017-09-11T17:09:18+00:00",
- "updated_at": "2018-01-20T03:44:39+00:00"
}
Requires sightmap.units.delete
permission.
asset required | string <id> <= 255 characters An asset ID. |
unit required | string <id> <= 255 characters A unit ID. |
{- "id": "258670",
- "asset_id": "1323",
- "building_id": "8265",
- "floor_id": "4730",
- "floor_plan_id": "14641",
- "map_id": "258670",
- "unit_number": "E13",
- "area": 700,
- "view_image_url": null,
- "secondary_view_image_url": null,
- "created_at": "2017-09-11T17:09:18+00:00",
- "updated_at": "2018-01-20T03:44:39+00:00"
}
Returns a list of unit outbound links.
Requires sightmap.unit-outbound-links.read
permission.
asset required | string <id> <= 255 characters An asset ID. |
page | integer <int32> Request a specific page of resources. |
per-page | integer <int32> Limit the number of returned resources. |
{- "paging": {
- "per_page": 100,
- "current_page": 1,
- "prev_url": null,
- "next_url": null
}, - "data": [
- {
- "id": "6011",
- "asset_id": "1323",
- "type": "iframe_api",
- "name": "360 Tour",
- "label": "View 360 Tour",
- "event_key": "website360Tour",
- "created_at": "2017-09-11T17:09:17+00:00",
- "updated_at": "2019-01-02T22:01:09+00:00"
}
]
}
Create a unit outbound link for an asset.
Requires sightmap.unit-outbound-links.create
permission.
asset required | string <id> <= 255 characters An asset ID. |
asset_id required | string <id> <= 255 characters The asset the outbound link belongs to. |
type required | string Enum: "iframe_api" "url_template" "urls_per_unit" The type determines how the unit outbound link behaves in the application and what actionable data is stored.
|
name required | string <= 255 characters |
label | string or null <= 95 characters The text label on the outbound link. |
event_key required | string <= 63 characters [a-z0-9-] A value used in all IFrame event names for the outbound link. For example when |
{- "asset_id": "1323",
- "type": "iframe_api",
- "name": "360 Tour",
- "label": "View 360 Tour",
- "event_key": "website360Tour"
}
{- "id": "6011",
- "asset_id": "1323",
- "type": "iframe_api",
- "name": "360 Tour",
- "label": "View 360 Tour",
- "event_key": "website360Tour",
- "created_at": "2017-09-11T17:09:17+00:00",
- "updated_at": "2019-01-02T22:01:09+00:00"
}
Returns a specific unit outbound link.
Requires sightmap.unit-outbound-links.read
permission.
asset required | string <id> <= 255 characters An asset ID. |
outbound-link required | string <id> <= 255 characters A unit outbound link ID. |
{- "id": "6011",
- "asset_id": "1323",
- "type": "iframe_api",
- "name": "360 Tour",
- "label": "View 360 Tour",
- "event_key": "website360Tour",
- "created_at": "2017-09-11T17:09:17+00:00",
- "updated_at": "2019-01-02T22:01:09+00:00"
}
Requires sightmap.unit-outbound-links.create
permission.
asset required | string <id> <= 255 characters An asset ID. |
outbound-link required | string <id> <= 255 characters A unit outbound link ID. |
id required | string <id> <= 255 characters |
asset_id required | string <id> <= 255 characters The asset the outbound link belongs to. |
type required | string Enum: "iframe_api" "url_template" "urls_per_unit" The type determines how the unit outbound link behaves in the application and what actionable data is stored.
|
name | string <= 255 characters |
label | string or null <= 95 characters The text label on the outbound link. |
event_key | string <= 63 characters [a-z0-9-] A value used in all IFrame event names for the outbound link. For example when |
{- "id": "6011",
- "name": "360 Tour",
- "type": "iframe_api",
- "label": "View 360 Tour",
- "event_key": "website360Tour"
}
{- "id": "6011",
- "asset_id": "1323",
- "type": "iframe_api",
- "name": "360 Tour",
- "label": "View 360 Tour",
- "event_key": "website360Tour",
- "created_at": "2017-09-11T17:09:17+00:00",
- "updated_at": "2019-01-02T22:01:09+00:00"
}
Returns a list of URLs for each unit when the unit outbound link type is
urls_per_unit
.
Requires sightmap.unit-outbound-links.read
permission.
asset required | string <id> <= 255 characters An asset ID. |
outbound-link required | string <id> <= 255 characters A unit outbound link ID. |
page | integer <int32> Request a specific page of resources. |
per-page | integer <int32> Limit the number of returned resources. |
{- "paging": {
- "per_page": 100,
- "current_page": 1,
- "prev_url": null,
- "next_url": null
},
}
Update a URL for any or all units when the unit outbound link type is
urls_per_unit
.
Requires sightmap.unit-outbound-links.update
permission.
asset required | string <id> <= 255 characters An asset ID. |
outbound-link required | string <id> <= 255 characters A unit outbound link ID. |
Array of objects | |||||
Array
|
{- "data": [
]
}
{- "message": "No API key found in request"
}
Returns a list of unit description groups for an asset.
Requires sightmap.unit-descriptions.read
permission.
NOTICE: This resource is experimental and requires the
unit-descriptions-resource
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
page | integer <int32> Request a specific page of resources. |
per-page | integer <int32> Limit the number of returned resources. |
Experimental-Flags required | string This resource is experimental and requires the |
{- "paging": {
- "per_page": 100,
- "current_page": 1,
- "prev_url": null,
- "next_url": null
}, - "data": [
- {
- "id": "7",
- "asset_id": "1323",
- "name": "Amenities",
- "created_at": "2017-09-11T17:09:17+00:00",
- "updated_at": "2019-01-02T22:01:09+00:00"
}
]
}
Create a unit description group.
Requires sightmap.unit-descriptions.create
permission.
NOTICE: This resource is experimental and requires the
unit-descriptions-resource
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
Experimental-Flags required | string This resource is experimental and requires the |
asset_id required | string <id> <= 255 characters The asset the unit description group belongs to. |
name required | string <= 255 characters |
{- "asset_id": "1323",
- "name": "Amenities"
}
{- "id": "7",
- "asset_id": "1323",
- "name": "Amenities",
- "created_at": "2017-09-11T17:09:17+00:00",
- "updated_at": "2019-01-02T22:01:09+00:00"
}
Returns a specific unit description group.
Requires sightmap.unit-descriptions.read
permission.
NOTICE: This resource is experimental and requires the
unit-descriptions-resource
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
group required | string <id> <= 255 characters A unit description group ID. |
Experimental-Flags required | string This resource is experimental and requires the |
{- "id": "7",
- "asset_id": "1323",
- "name": "Amenities",
- "created_at": "2017-09-11T17:09:17+00:00",
- "updated_at": "2019-01-02T22:01:09+00:00"
}
Update a unit description group.
Requires sightmap.unit-descriptions.update
permission.
NOTICE: This resource is experimental and requires the
unit-descriptions-resource
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
group required | string <id> <= 255 characters A unit description group ID. |
Experimental-Flags required | string This resource is experimental and requires the |
id required | string <id> <= 255 characters |
asset_id required | string <id> <= 255 characters The asset the unit description group belongs to. |
name required | string <= 255 characters |
{- "id": "7",
- "asset_id": "1323",
- "name": "Amenities"
}
{- "id": "7",
- "asset_id": "1323",
- "name": "Amenities",
- "created_at": "2017-09-11T17:09:17+00:00",
- "updated_at": "2019-01-02T22:01:09+00:00"
}
Returns a list of descriptions for a unit description group.
Requires sightmap.unit-descriptions.read
permission.
NOTICE: This resource is experimental and requires the
unit-descriptions-resource
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
group required | string <id> <= 255 characters A unit description group ID. |
page | integer <int32> Request a specific page of resources. |
per-page | integer <int32> Limit the number of returned resources. |
Experimental-Flags required | string This resource is experimental and requires the |
{- "paging": {
- "per_page": 100,
- "current_page": 1,
- "prev_url": null,
- "next_url": null
}, - "data": [
- {
- "id": "1000",
- "asset_id": "1323",
- "group_id": "7",
- "name": "Amenity 1",
- "label": "Amenities",
- "body": "* Quartz countertops\n* Mountain views\n* Stainless steel appliances\n",
- "is_enabled": true,
- "created_at": "2017-09-11T17:09:17+00:00",
- "updated_at": "2019-01-02T22:01:09+00:00"
}
]
}
Create one or more unit descriptions.
Requires sightmap.unit-descriptions.create
permission.
NOTICE: This resource is experimental and requires the
unit-descriptions-resource
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
group required | string <id> <= 255 characters A unit description group ID. |
Experimental-Flags required | string This resource is experimental and requires the |
Array of objects | |||||||||||
Array
|
{- "data": [
- {
- "group_id": "7",
- "name": "Amenity 1",
- "label": "Amenities",
- "body": "* Quartz countertops\n* Mountain views\n* Stainless steel appliances\n",
- "is_enabled": true
}, - {
- "group_id": "7",
- "name": "Amenity 2",
- "label": "Amenities",
- "body": "* Granite countertops\n* Ocean views\n* Black steel appliances\n",
- "is_enabled": true
}
]
}
{- "data": [
- {
- "id": "1000",
- "asset_id": "1323",
- "group_id": "7",
- "name": "Amenity 1",
- "label": "Amenities",
- "body": "* Quartz countertops\n* Mountain views\n* Stainless steel appliances\n",
- "is_enabled": true,
- "created_at": "2017-09-11T17:09:17+00:00",
- "updated_at": "2019-01-02T22:01:09+00:00"
}, - {
- "id": "1001",
- "asset_id": "1323",
- "group_id": "7",
- "name": "Amenity 2",
- "label": "Amenities",
- "body": "* Granite countertops\n* Ocean views\n* Black steel appliances\n",
- "is_enabled": true,
- "created_at": "2017-09-11T17:09:17+00:00",
- "updated_at": "2019-01-02T22:01:09+00:00"
}
]
}
Update one or more unit descriptions.
Requires sightmap.unit-descriptions.update
permission.
NOTICE: This resource is experimental and requires the
unit-descriptions-resource
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
group required | string <id> <= 255 characters A unit description group ID. |
Experimental-Flags required | string This resource is experimental and requires the |
Array of objects | |||||||||||||
Array
|
{- "data": [
- {
- "id": "1000",
- "group_id": "7",
- "name": "Amenity 1",
- "label": "Amenities",
- "body": "* Quartz countertops\n* Mountain views\n* Stainless steel appliances\n",
- "is_enabled": true
}, - {
- "id": "1001",
- "group_id": "7",
- "name": "Amenity 2",
- "label": "Amenities",
- "body": "* Granite countertops\n* Ocean views\n* Black steel appliances\n",
- "is_enabled": true
}
]
}
{- "data": [
- {
- "id": "1000",
- "asset_id": "1323",
- "group_id": "7",
- "name": "Amenity 1",
- "label": "Amenities",
- "body": "* Quartz countertops\n* Mountain views\n* Stainless steel appliances\n",
- "is_enabled": true,
- "created_at": "2017-09-11T17:09:17+00:00",
- "updated_at": "2019-01-02T22:01:09+00:00"
}, - {
- "id": "1001",
- "asset_id": "1323",
- "group_id": "7",
- "name": "Amenity 2",
- "label": "Amenities",
- "body": "* Granite countertops\n* Ocean views\n* Black steel appliances\n",
- "is_enabled": true,
- "created_at": "2017-09-11T17:09:17+00:00",
- "updated_at": "2019-01-02T22:01:09+00:00"
}
]
}
Returns a specific unit description.
Requires sightmap.unit-descriptions.read
permission.
NOTICE: This resource is experimental and requires the
unit-descriptions-resource
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
group required | string <id> <= 255 characters A unit description group ID. |
description required | string <id> <= 255 characters A unit description ID. |
Experimental-Flags required | string This resource is experimental and requires the |
{- "id": "1000",
- "asset_id": "1323",
- "group_id": "7",
- "name": "Amenity 1",
- "label": "Amenities",
- "body": "* Quartz countertops\n* Mountain views\n* Stainless steel appliances\n",
- "is_enabled": true,
- "created_at": "2017-09-11T17:09:17+00:00",
- "updated_at": "2019-01-02T22:01:09+00:00"
}
Returns a list of units for a unit description group.
Requires sightmap.unit-descriptions.read
permission.
NOTICE: This resource is experimental and requires the
unit-descriptions-resource
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
group required | string <id> <= 255 characters A unit description group ID. |
page | integer <int32> Request a specific page of resources. |
per-page | integer <int32> Limit the number of returned resources. |
Experimental-Flags required | string This resource is experimental and requires the |
{- "paging": {
- "per_page": 100,
- "current_page": 1,
- "prev_url": null,
- "next_url": null
}, - "data": [
- {
- "asset_id": "1323",
- "group_id": "7",
- "unit_id": "258670",
- "description_id": "1000"
}
]
}
Assign one or more units to one or more descriptions.
Requires sightmap.unit-descriptions.update
permission.
NOTICE: This resource is experimental and requires the
unit-descriptions-resource
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
group required | string <id> <= 255 characters A unit description group ID. |
Experimental-Flags required | string This resource is experimental and requires the |
Array of objects | |||||||
Array
|
{- "data": [
- {
- "group_id": "7",
- "unit_id": "258670",
- "description_id": "1000"
}, - {
- "group_id": "7",
- "unit_id": "258671",
- "description_id": "1001"
}
]
}
{- "data": [
- {
- "asset_id": "1323",
- "group_id": "7",
- "unit_id": "258670",
- "description_id": "1000"
}, - {
- "asset_id": "1323",
- "group_id": "7",
- "unit_id": "258671",
- "description_id": "1001"
}
]
}
Returns a list of floors for an asset.
Requires sightmap.floors.read
permission.
asset required | string <id> <= 255 characters An asset ID. |
page | integer <int32> Request a specific page of resources. |
per-page | integer <int32> Limit the number of returned resources. |
{- "paging": {
- "per_page": 100,
- "current_page": 1,
- "prev_url": null,
- "next_url": null
}, - "data": [
- {
- "id": "4730",
- "asset_id": "1323",
- "name": "1",
- "filter_label": "Floor 1",
- "filter_short_label": "1",
- "sort": 2,
- "created_at": "2017-09-11T17:09:17+00:00",
- "updated_at": "2019-01-02T22:01:09+00:00"
}
]
}
Create a floor for an asset.
Requires sightmap.floors.create
permission.
asset required | string <id> <= 255 characters An asset ID. |
asset_id required | string <id> <= 255 characters The asset the floor belongs to. |
name required | string <= 255 characters |
filter_label required | string <= 255 characters The default filter label for the floor. |
filter_short_label required | string <= 4 characters The default short filter label for the floor. |
sort required | integer <int32> The sort order of the floor. |
{- "asset_id": "1323",
- "name": "1",
- "filter_label": "Floor 1",
- "filter_short_label": "1",
- "sort": 2
}
{- "id": "4730",
- "asset_id": "1323",
- "name": "1",
- "filter_label": "Floor 1",
- "filter_short_label": "1",
- "sort": 2,
- "created_at": "2017-09-11T17:09:17+00:00",
- "updated_at": "2019-01-02T22:01:09+00:00"
}
Returns a specific floor.
Requires sightmap.floors.read
permission.
asset required | string <id> <= 255 characters An asset ID. |
floor required | string <id> <= 255 characters A floor ID. |
{- "id": "4730",
- "asset_id": "1323",
- "name": "1",
- "filter_label": "Floor 1",
- "filter_short_label": "1",
- "sort": 2,
- "created_at": "2017-09-11T17:09:17+00:00",
- "updated_at": "2019-01-02T22:01:09+00:00"
}
Requires sightmap.floors.update
permission.
asset required | string <id> <= 255 characters An asset ID. |
floor required | string <id> <= 255 characters A floor ID. |
id required | string <id> <= 255 characters |
asset_id required | string <id> <= 255 characters The asset the floor belongs to. |
name | string <= 255 characters |
filter_label | string <= 255 characters The default filter label for the floor. |
filter_short_label | string <= 4 characters The default short filter label for the floor. |
sort | integer <int32> The sort order of the floor. |
{- "id": "4730",
- "asset_id": "1323",
- "name": "1",
- "filter_label": "Floor 1",
- "filter_short_label": "1",
- "sort": 2
}
{- "id": "4730",
- "asset_id": "1323",
- "name": "1",
- "filter_label": "Floor 1",
- "filter_short_label": "1",
- "sort": 2,
- "created_at": "2017-09-11T17:09:17+00:00",
- "updated_at": "2019-01-02T22:01:09+00:00"
}
Returns a list of floor plans for an asset.
Requires sightmap.floor-plans.read
permission.
asset required | string <id> <= 255 characters An asset ID. |
page | integer <int32> Request a specific page of resources. |
per-page | integer <int32> Limit the number of returned resources. |
{- "paging": {
- "per_page": 100,
- "current_page": 1,
- "prev_url": null,
- "next_url": null
}, - "data": [
- {
- "id": "14641",
- "asset_id": "1323",
- "name": "1 Bed 1 Bath",
- "bedroom_count": 1,
- "bathroom_count": 1,
- "secondary_image_url": "https://cdn.sightmap.com/assets/dg/ow/dgow3mqzv2m/06/c6/06c6813818262c70904b9ae2dac39119.jpg",
- "filter_label": "1 Bed 1 Bath",
- "created_at": "2017-09-11T17:09:18+00:00",
- "updated_at": "2018-11-30T22:21:05+00:00"
}
]
}
Create a floor plan for an asset.
Requires sightmap.floor-plans.create
permission.
asset required | string <id> <= 255 characters An asset ID. |
asset_id required | string <id> <= 255 characters The asset the floor plan belongs to. |
name required | string <= 255 characters |
bedroom_count required | integer <int32> >= 0 The number of bedrooms. |
bathroom_count required | number <float> >= 0 The number of bathrooms. Fractional values represent partial baths (e.g. |
filter_label required | string <= 255 characters |
{- "asset_id": "1323",
- "name": "1 Bed 1 Bath",
- "bedroom_count": 1,
- "bathroom_count": 1,
- "filter_label": "1 Bed 1 Bath"
}
{- "id": "14641",
- "asset_id": "1323",
- "name": "1 Bed 1 Bath",
- "bedroom_count": 1,
- "bathroom_count": 1,
- "secondary_image_url": "https://cdn.sightmap.com/assets/dg/ow/dgow3mqzv2m/06/c6/06c6813818262c70904b9ae2dac39119.jpg",
- "filter_label": "1 Bed 1 Bath",
- "created_at": "2017-09-11T17:09:18+00:00",
- "updated_at": "2018-11-30T22:21:05+00:00"
}
Returns a specific floor plan.
asset required | string <id> <= 255 characters An asset ID. |
floor-plan required | string <id> <= 255 characters A floor plan ID. |
{- "id": "14641",
- "asset_id": "1323",
- "name": "1 Bed 1 Bath",
- "bedroom_count": 1,
- "bathroom_count": 1,
- "secondary_image_url": "https://cdn.sightmap.com/assets/dg/ow/dgow3mqzv2m/06/c6/06c6813818262c70904b9ae2dac39119.jpg",
- "filter_label": "1 Bed 1 Bath",
- "created_at": "2017-09-11T17:09:18+00:00",
- "updated_at": "2018-11-30T22:21:05+00:00"
}
Requires sightmap.floor-plans.update
permission.
asset required | string <id> <= 255 characters An asset ID. |
floor-plan required | string <id> <= 255 characters A floor plan ID. |
id required | string <id> <= 255 characters |
asset_id required | string <id> <= 255 characters The asset the floor plan belongs to. |
name | string <= 255 characters |
bedroom_count | integer <int32> >= 0 The number of bedrooms. |
bathroom_count | number <float> >= 0 The number of bathrooms. Fractional values represent partial baths (e.g. |
image | string Value: "delete" Delete the primary image of the floor plan. |
secondary_image | string Value: "delete" Delete the secondary image of the floor plan. |
filter_label | string <= 65 characters |
{- "id": "14641",
- "asset_id": "1323",
- "name": "1 Bed 1 Bath",
- "bedroom_count": 1,
- "bathroom_count": 1,
- "filter_label": "1 Bed 1 Bath"
}
{- "id": "14641",
- "asset_id": "1323",
- "name": "1 Bed 1 Bath",
- "bedroom_count": 1,
- "bathroom_count": 1,
- "secondary_image_url": "https://cdn.sightmap.com/assets/dg/ow/dgow3mqzv2m/06/c6/06c6813818262c70904b9ae2dac39119.jpg",
- "filter_label": "1 Bed 1 Bath",
- "created_at": "2017-09-11T17:09:18+00:00",
- "updated_at": "2018-11-30T22:21:05+00:00"
}
Requires sightmap.floor-plans.delete
permission.
asset required | string <id> <= 255 characters An asset ID. |
floor-plan required | string <id> <= 255 characters A floor plan ID. |
{- "id": "14641",
- "asset_id": "1323",
- "name": "1 Bed 1 Bath",
- "bedroom_count": 1,
- "bathroom_count": 1,
- "secondary_image_url": "https://cdn.sightmap.com/assets/dg/ow/dgow3mqzv2m/06/c6/06c6813818262c70904b9ae2dac39119.jpg",
- "filter_label": "1 Bed 1 Bath",
- "created_at": "2017-09-11T17:09:18+00:00",
- "updated_at": "2018-11-30T22:21:05+00:00"
}
Returns a list of buildings for an asset.
Requires sightmap.buildings.read
permission.
asset required | string <id> <= 255 characters An asset ID. |
page | integer <int32> Request a specific page of resources. |
per-page | integer <int32> Limit the number of returned resources. |
{- "paging": {
- "per_page": 100,
- "current_page": 1,
- "prev_url": null,
- "next_url": null
}, - "data": [
- {
- "id": "8267",
- "asset_id": "1323",
- "name": "W",
- "created_at": "2017-09-11T17:09:18+00:00",
- "updated_at": "2017-09-11T17:09:18+00:00"
}
]
}
Create a building for an asset.
Requires sightmap.buildings.create
permission.
asset required | string <id> <= 255 characters An asset ID. |
asset_id required | string <id> <= 255 characters The asset the building belongs to. |
name required | string <= 255 characters |
{- "asset_id": "1323",
- "name": "W"
}
{- "id": "8267",
- "asset_id": "1323",
- "name": "W",
- "created_at": "2017-09-11T17:09:18+00:00",
- "updated_at": "2017-09-11T17:09:18+00:00"
}
Returns a specific building.
Requires sightmap.buildings.read
permission.
asset required | string <id> <= 255 characters An asset ID. |
building required | string <id> <= 255 characters A building ID. |
{- "id": "8267",
- "asset_id": "1323",
- "name": "W",
- "created_at": "2017-09-11T17:09:18+00:00",
- "updated_at": "2017-09-11T17:09:18+00:00"
}
Requires sightmap.buildings.update
permission.
asset required | string <id> <= 255 characters An asset ID. |
building required | string <id> <= 255 characters A building ID. |
id required | string <id> <= 255 characters |
asset_id required | string <id> <= 255 characters The asset the building belongs to. |
name required | string <= 255 characters |
{- "id": "8267",
- "asset_id": "1323",
- "name": "W"
}
{- "id": "8267",
- "asset_id": "1323",
- "name": "W",
- "created_at": "2017-09-11T17:09:18+00:00",
- "updated_at": "2017-09-11T17:09:18+00:00"
}
Returns a list of amenities for an asset.
Requires sightmap.amenities.read
permission.
NOTICE: This resource is experimental and requires the
amenity-resource
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
page | integer <int32> Request a specific page of resources. |
per-page | integer <int32> Limit the number of returned resources. |
Experimental-Flags required | string This resource is experimental and requires the |
{- "paging": {
- "per_page": 100,
- "current_page": 1,
- "prev_url": null,
- "next_url": null
}, - "data": [
- {
- "id": "8267",
- "asset_id": "1323",
- "gallery_id": "3321",
- "name": "Infinity Pool",
- "label": "Infinity Pool",
- "description": "An infinity pool is a reflecting or swimming pool, where the water flows over one or more edges, producing a visual effect of water with no boundary. Such pools are often designed so that the edge appears to merge with a larger body of water such as the ocean, or with the sky. They are often seen at resorts, estates, and in other luxurious places.",
- "iframe_source_url": null,
- "created_at": "2017-09-11T17:09:18+00:00",
- "updated_at": "2017-09-11T17:09:18+00:00"
}
]
}
Returns a specific amenity.
Requires sightmap.amenities.read
permission.
NOTICE: This resource is experimental and requires the
amenity-resource
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
amenity required | string <id> <= 255 characters An amenity ID. |
Experimental-Flags required | string This resource is experimental and requires the |
{- "id": "8267",
- "asset_id": "1323",
- "gallery_id": "3321",
- "name": "Infinity Pool",
- "label": "Infinity Pool",
- "description": "An infinity pool is a reflecting or swimming pool, where the water flows over one or more edges, producing a visual effect of water with no boundary. Such pools are often designed so that the edge appears to merge with a larger body of water such as the ocean, or with the sky. They are often seen at resorts, estates, and in other luxurious places.",
- "iframe_source_url": null,
- "created_at": "2017-09-11T17:09:18+00:00",
- "updated_at": "2017-09-11T17:09:18+00:00"
}
Returns a list of image galleries for an asset.
Requires sightmap.galleries.read
permission.
NOTICE: This resource is experimental and requires the
gallery-resource
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
page | integer <int32> Request a specific page of resources. |
per-page | integer <int32> Limit the number of returned resources. |
Experimental-Flags required | string This resource is experimental and requires the |
{- "paging": {
- "per_page": 100,
- "current_page": 1,
- "prev_url": null,
- "next_url": null
}, - "data": [
- {
- "id": "8267",
- "asset_id": "1323",
- "name": "Infinity Pool",
- "images": [
], - "created_at": "2017-09-11T17:09:18+00:00",
- "updated_at": "2017-09-11T17:09:18+00:00"
}
]
}
Returns a specific image gallery.
NOTICE: This resource is experimental and requires the
gallery-resource
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
gallery required | string <id> <= 255 characters A gallery ID. |
Experimental-Flags required | string This resource is experimental and requires the |
{- "id": "8267",
- "asset_id": "1323",
- "name": "Infinity Pool",
- "images": [
], - "created_at": "2017-09-11T17:09:18+00:00",
- "updated_at": "2017-09-11T17:09:18+00:00"
}
Returns a list of unit maps for an asset.
Requires sightmap.unit-maps.read
permission.
asset required | string <id> <= 255 characters An asset ID. |
page | integer <int32> Request a specific page of resources. |
per-page | integer <int32> Limit the number of returned resources. |
tags | string <id> <= 255 characters A comma-separated list of one or more tags to filter the list on (e.g. |
{- "paging": {
- "per_page": 100,
- "current_page": 1,
- "prev_url": null,
- "next_url": null
}, - "data": [
- {
- "id": "575",
- "asset_id": "1323",
- "name": "The Lofts at New Main",
- "is_dimension_locked": false,
- "style": "b",
- "style_type": "floor_plate",
- "tags": [
- "ils",
- "mls"
], - "geojson_url": null,
- "created_at": "2017-09-13T15:35:35+00:00",
- "updated_at": "2020-02-28T21:24:51+00:00"
}
]
}
Create a Unit Map for an asset.
Requires sightmap.unit-maps.create
permission.
NOTICE: This resource is experimental and requires the create-unitmap-resource
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
Experimental-Flags required | string This resource is experimental and requires the |
required | object | ||||||||
| |||||||||
file required | string <binary> The unit map file. Must be a .umap file. | ||||||||
source required | string <binary> The unit map source file. Must be either an .svg, .ai, or .pdf file. |
{- "id": "575",
- "asset_id": "1323",
- "name": "The Lofts at New Main",
- "is_dimension_locked": false,
- "style": "b",
- "style_type": "floor_plate",
- "tags": [
- "ils",
- "mls"
], - "geojson_url": null,
- "created_at": "2017-09-13T15:35:35+00:00",
- "updated_at": "2020-02-28T21:24:51+00:00"
}
Returns a specific unit map.
Requires sightmap.unit-maps.read
permission.
asset required | string <id> <= 255 characters An asset ID. |
map required | string <id> <= 255 characters A unit map ID. |
{- "id": "575",
- "asset_id": "1323",
- "name": "The Lofts at New Main",
- "is_dimension_locked": false,
- "style": "b",
- "style_type": "floor_plate",
- "tags": [
- "ils",
- "mls"
], - "geojson_url": null,
- "created_at": "2017-09-13T15:35:35+00:00",
- "updated_at": "2020-02-28T21:24:51+00:00"
}
Requires sightmap.unit-maps.update
permission.
asset required | string <id> <= 255 characters An asset ID. |
map required | string <id> <= 255 characters A unit map ID. |
id required | string <id> <= 255 characters |
asset_id required | string <id> <= 255 characters The asset the unit map belongs to. |
name | string <= 255 characters |
tags | Array of strings <= 255 characters <= 3 items ^[a-z]{1}[a-z0-9-]{1,254}$ The tags assigned to the unit map. |
is_dimension_locked | boolean Default: false |
style | string Enum: "a" "a.1" "a.2" "b" "c" "d" "e" "f.1" "f.2" "f.3" "g.1" "g.2" "h" "x" The defined style of the unit map. |
{- "id": "575",
- "asset_id": "1323",
- "name": "The Lofts at New Main",
- "tags": [
- "ils",
- "mls"
], - "style": "b"
}
{- "id": "575",
- "asset_id": "1323",
- "name": "The Lofts at New Main",
- "is_dimension_locked": false,
- "style": "b",
- "style_type": "floor_plate",
- "tags": [
- "ils",
- "mls"
], - "geojson_url": null,
- "created_at": "2017-09-13T15:35:35+00:00",
- "updated_at": "2020-02-28T21:24:51+00:00"
}
Returns a list of backgrounds for the unit map.
Requires sightmap.unit-maps.read
permission.
asset required | string <id> <= 255 characters An asset ID. |
map required | string <id> <= 255 characters A unit map ID. |
page | integer <int32> Request a specific page of resources. |
per-page | integer <int32> Limit the number of returned resources. |
{- "paging": {
- "per_page": 100,
- "current_page": 1,
- "prev_url": null,
- "next_url": null
}, - "data": [
- {
- "id": "1395",
- "asset_id": "1323",
- "unit_map_id": "5416",
- "name": "The Lofts at New Main",
- "created_at": "2017-09-13T15:35:35+00:00",
- "updated_at": "2020-02-28T21:24:51+00:00"
}
]
}
Returns a specific background for a unit map.
Requires sightmap.unit-maps.read
permission.
asset required | string <id> <= 255 characters An asset ID. |
map required | string <id> <= 255 characters A unit map ID. |
background required | string <id> <= 255 characters A background ID. |
{- "id": "1395",
- "asset_id": "1323",
- "unit_map_id": "5416",
- "name": "The Lofts at New Main",
- "created_at": "2017-09-13T15:35:35+00:00",
- "updated_at": "2020-02-28T21:24:51+00:00"
}
Builds and/or rebuilds all caches for an asset.
Requires sightmap.caches.build
permission.
NOTICE: This resource is experimental and requires the build-caches
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
Experimental-Flags required | string This resource is experimental and requires the |
{- "message": "No API key found in request"
}
Returns a list of asset references for an asset.
Requires sightmap.asset-references.read
permission.
NOTICE: This resource is experimental and requires the
references
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
page | integer <int32> Request a specific page of resources. |
per-page | integer <int32> Limit the number of returned resources. |
Experimental-Flags required | string This resource is experimental and requires the |
{- "paging": {
- "per_page": 100,
- "current_page": 1,
- "prev_url": null,
- "next_url": null
}, - "data": [
- {
- "id": "2630",
- "asset_id": "4715",
- "name": "Google Places",
- "description": null,
- "key": "google-places",
- "value": "ChIJuw4JzfOGbIcR1PPArQtuTcQ",
- "created_at": "2021-03-11T17:09:18+00:00",
- "updated_at": "2021-01-20T03:44:39+00:00"
}
]
}
Create an asset reference for an asset.
Requires sightmap.asset-references.create
permission.
NOTICE: This resource is experimental and requires the
references
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
Experimental-Flags required | string This resource is experimental and requires the |
asset_id required | string <id> <= 255 characters The asset the reference belongs to. |
name required | string <= 255 characters |
description | string or null <= 255 characters |
key | string or null <= 255 characters ^[a-z]{1}[a-z0-9-]{1,254}$ A string used across resources to indicate the third-party system the reference value is part of. The key cannot be used more than once per asset, which ensures only a single reference may exist per asset for each key. |
value required | string <= 255 characters The matched reference value to the asset. |
{- "asset_id": "4715",
- "name": "Google Places",
- "key": "google-places",
- "value": "ChIJuw4JzfOGbIcR1PPArQtuTcQ"
}
{- "id": "2630",
- "asset_id": "4715",
- "name": "Google Places",
- "description": null,
- "key": "google-places",
- "value": "ChIJuw4JzfOGbIcR1PPArQtuTcQ",
- "created_at": "2021-03-11T17:09:18+00:00",
- "updated_at": "2021-01-20T03:44:39+00:00"
}
Returns a specific asset reference.
Requires sightmap.asset-references.read
permission.
NOTICE: This resource is experimental and requires the
references
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
reference required | string <id> <= 255 characters An asset reference ID. |
Experimental-Flags required | string This resource is experimental and requires the |
{- "id": "2630",
- "asset_id": "4715",
- "name": "Google Places",
- "description": null,
- "key": "google-places",
- "value": "ChIJuw4JzfOGbIcR1PPArQtuTcQ",
- "created_at": "2021-03-11T17:09:18+00:00",
- "updated_at": "2021-01-20T03:44:39+00:00"
}
Requires sightmap.asset-references.update
permission.
asset required | string <id> <= 255 characters An asset ID. |
reference required | string <id> <= 255 characters An asset reference ID. |
Experimental-Flags required | string This resource is experimental and requires the |
id required | string <id> <= 255 characters |
asset_id required | string <id> <= 255 characters The asset the reference belongs to. |
name | string <= 255 characters |
description | string or null <= 255 characters |
key | string or null <= 255 characters ^[a-z]{1}[a-z0-9-]{1,254}$ A string used across resources to indicate the third-party system the reference value is part of. The key cannot be used more than once per asset, which ensures only a single reference may exist per asset for each key. |
value required | string <= 255 characters The matched reference value to the asset. |
{- "id": "2630",
- "asset_id": "4715",
- "name": "Google Places",
- "description": null,
- "key": "google-places",
- "value": "ChIJuw4JzfOGbIcR1PPArQtuTcQ"
}
{- "id": "2630",
- "asset_id": "4715",
- "name": "Google Places",
- "description": null,
- "key": "google-places",
- "value": "ChIJuw4JzfOGbIcR1PPArQtuTcQ",
- "created_at": "2021-03-11T17:09:18+00:00",
- "updated_at": "2021-01-20T03:44:39+00:00"
}
Returns a list of unit reference groups for an asset.
Requires sightmap.unit-references.read
permission.
NOTICE: This resource is experimental and requires the
references
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
page | integer <int32> Request a specific page of resources. |
per-page | integer <int32> Limit the number of returned resources. |
Experimental-Flags required | string This resource is experimental and requires the |
{- "paging": {
- "per_page": 100,
- "current_page": 1,
- "prev_url": null,
- "next_url": null
}, - "data": [
- {
- "id": "2630",
- "asset_id": "1323",
- "name": "Yardi Voyager",
- "key": "yardi-voyager",
- "created_at": "2017-09-11T17:09:17+00:00",
- "updated_at": "2019-01-02T22:01:09+00:00"
}
]
}
Create a unit reference group.
Requires sightmap.unit-references.create
permission.
NOTICE: This resource is experimental and requires the
references
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
Experimental-Flags required | string This resource is experimental and requires the |
asset_id required | string <id> <= 255 characters The asset the unit reference group belongs to. |
name required | string <= 255 characters |
description | string or null <= 255 characters |
key | string or null <= 255 characters ^[a-z]{1}[a-z0-9-]{1,254}$ A string used across resources to indicate the third-party system the references are part of. The key cannot be used more than once per asset, which ensures only a single reference group may exist per asset for each key. |
{- "asset_id": "1323",
- "name": "Yardi Voyager",
- "key": "yardi-voyager"
}
{- "id": "2630",
- "asset_id": "1323",
- "name": "Yardi Voyager",
- "key": "yardi-voyager",
- "created_at": "2017-09-11T17:09:17+00:00",
- "updated_at": "2019-01-02T22:01:09+00:00"
}
Returns a specific unit reference group.
Requires sightmap.unit-references.read
permission.
NOTICE: This resource is experimental and requires the
references
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
group required | string <id> <= 255 characters A unit reference group ID. |
Experimental-Flags required | string This resource is experimental and requires the |
{- "id": "2630",
- "asset_id": "1323",
- "name": "Yardi Voyager",
- "key": "yardi-voyager",
- "created_at": "2017-09-11T17:09:17+00:00",
- "updated_at": "2019-01-02T22:01:09+00:00"
}
Update a unit reference group.
Requires sightmap.unit-references.update
permission.
NOTICE: This resource is experimental and requires the
references
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
group required | string <id> <= 255 characters A unit reference group ID. |
Experimental-Flags required | string This resource is experimental and requires the |
id required | string <id> <= 255 characters |
asset_id required | string <id> <= 255 characters The asset the unit reference group belongs to. |
name | string <= 255 characters |
description | string or null <= 255 characters |
key | string or null <= 255 characters ^[a-z]{1}[a-z0-9-]{1,254}$ A string used across resources to indicate the third-party system the references are part of. The key cannot be used more than once per asset, which ensures only a single reference group may exist per asset for each key. |
{- "id": "2630",
- "asset_id": "1323",
- "name": "Yardi Voyager",
- "key": "yardi-voyager"
}
{- "id": "2630",
- "asset_id": "1323",
- "name": "Yardi Voyager",
- "key": "yardi-voyager",
- "created_at": "2017-09-11T17:09:17+00:00",
- "updated_at": "2019-01-02T22:01:09+00:00"
}
Returns a list of references for a unit reference group.
Requires sightmap.unit-references.read
permission.
NOTICE: This resource is experimental and requires the
references
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
group required | string <id> <= 255 characters A unit reference group ID. |
page | integer <int32> Request a specific page of resources. |
per-page | integer <int32> Limit the number of returned resources. |
Experimental-Flags required | string This resource is experimental and requires the |
{- "paging": {
- "per_page": 100,
- "current_page": 1,
- "prev_url": null,
- "next_url": null
}, - "data": [
- {
- "group_id": "2630",
- "asset_id": "1323",
- "unit_id": "258670",
- "key": "yardi-voyager",
- "value": "123456",
- "created_at": "2021-03-11T17:09:18+00:00",
- "updated_at": "2021-01-20T03:44:39+00:00"
}
]
}
Update one or more references on a unit reference group.
Requires sightmap.unit-references.update
permission.
NOTICE: This resource is experimental and requires the
references
experimental flag.
asset required | string <id> <= 255 characters An asset ID. |
group required | string <id> <= 255 characters A unit reference group ID. |
Experimental-Flags required | string This resource is experimental and requires the |
Array of objects | |||||||
Array
|
{- "data": [
- [
- {
- "group_id": "2630",
- "unit_id": "258670",
- "value": "123456"
}, - {
- "group_id": "2630",
- "unit_id": "258671",
- "value": "123457"
}
]
]
}
{- "message": "No API key found in request"
}
Returns the pricing processes for an asset.
Requires sightmap.pricing.read
permission.
asset required | string <id> <= 255 characters An asset ID. |
page | integer <int32> Request a specific page of resources. |
per-page | integer <int32> Limit the number of returned resources. |
{- "paging": {
- "per_page": 100,
- "current_page": 1,
- "prev_url": null,
- "next_url": null
}, - "data": [
- {
- "id": "1145",
- "asset_id": "1323",
- "name": "Lofts at New Main - Manual",
- "type": "manual",
- "pricing_strategy": "flat_pricing",
- "created_at": "2018-04-03T19:27:33+00:00",
- "updated_at": "2018-04-03T19:27:33+00:00"
}
]
}