ButterflyMX API V3
OAuth2 Authentication
The ButterflyMX API V3 implements the Authorization Grant Type Flow and issues an access_token along with a refresh_token. The Authorization Code grant type is used by confidential and public clients to exchange an authorization code for an access token.
Obtaining an authorization code (Authentication)
To begin the authorization flow, your application will need to construct a URL like the following and open a browser to that URL:
https://accountssandbox.butterflymx.com/oauth/authorize?client_id=$CLIENT_ID&redirect_uri=https://usersandbox.butterflymx.com/oauth/callbacks/butterflymx&response_type=code&client_secret=$CLIENT_SECRET
Obtaining an access_token
To obtain a valid access_token and refresh_token, your application will need to send the $CLIENT_ID, $CLIENT_SECRET and $code to the ButterflyMX token endpoint:
curl --location --request POST 'https://accountssandbox.butterflymx.com/oauth/token' \
--form 'grant_type=authorization_code' \
--form 'code=$code' \
--form 'client_id=$CLIENT_ID' \
--form 'client_secret=$CLIENT_SECRET' \
--form 'redirect_uri=https://usersandbox.butterflymx.com/oauth/callbacks/butterflymx'Response sample in case of success:
HTTP/1.1 200 OK
Content-Type: application/json
{
"access_token": "eyJ0eXAi...TcV3Q",
"token_type": "bearer",
"expires_in": 7200,
"refresh_token": "6d8cd1d...9f75",
"created_at": 1506068201
}Response sample in case that your $CLIENT_ID doesn’t exist, or you didn’t include your $CLIENT_SECRET in the request:
{
"error": "invalid_client",
"error_description": "Client authentication failed due to unknown client, no client authentication included, or unsupported authentication method."
}Renewal of the access_token
After access_token expiration, an app can call the same API authentication endpoint to exchange the refresh_token for a new, valid access_token:
curl -X POST "https://accountssandbox.butterflymx.com/oauth/token" \
-d grant_type=refresh_token \
-d refresh_token=6d8cd1d...9f75 \
-d client_id=$CLIENT_ID \
-d client_secret=$CLIENT_SECRETResponse sample in case of success:
HTTP/1.1 200 OK
Content-Type: application/json
{
"access_token": "eyJ0eXAi...",
"token_type": "bearer",
"expires_in": 7200,
"refresh_token": "6d8cd1d...",
"created_at": 1506068601
}Note:
After successful refresh action, the mobile app has to store new access_token and refresh_token (both are changed)!
Last issued refresh_token doesn’t expire (it is valid indefinitely) but is still subject to invalidation for other reasons.
In case that on the renewal request server responds with HTTP status 401, the app should immediately log-off user.
Response status 401, in this case, means that this refresh_token is invalid and refresh operation will not be possible.
For example, if the mobile phone is stolen or compromised, the refresh_token can be invalidated on the server side.
User Password Change
Users can change their password by sending a PUT or PATCH request to the ButterflyMX Accounts API. All password change requests need to include the access_token in the Authorization header like this:
curl -X PUT 'https://accounts.butterflymx.com/api/v1/password' \
-H 'Authorization:Bearer eyJ0eXAi...TcV3Q' \
--data-urlencode 'account[current_password]=password' \
--data-urlencode 'account[password]=new_password' \
--data-urlencode 'account[password_confirmation]=new_password'In case of the successful password change, the server will return HTTP status 204 No Content.
In case that current password was not correct, the server will respond with a ‘Wrong password’ message in the errors key, like this:
HTTP/1.1 422 Unprocessable Entity
Content-Type: application/json
{ "errors" : "Wrong password" }In case of any other errors while updating password, full error messages will be returned. The most common (and probably only) case where this could happen is when there is a password and password_confirmation values mismatch, like this:
HTTP/1.1 422 Unprocessable Entity
Content-Type: application/json
{ "errors" : ["Password confirmation doesn't match Password"] }User Roles
Authenticated user can have any of the following roles (authorizations):
-
Tenant
-
Unit Admin
-
Zone Admin
-
Building Admin
Data Models
ButterflyMX Building model is divided into zones (e.g., residential, business, etc.). Zones can’t overlap. Each zone can contain many units. A unit can be apartment, office, garage, etc.
-
building has many zones
-
zone belongs to only one building
-
zone has many units
-
unit belongs to only one zone
-
user can be a tenant in many units
-
unit can have many tenants (users)
JSON API Specification
ButterflyMX API V3 implements latest JSON API Specification (v1.0) published at: http://jsonapi.org/format/
Pagination
Pagination use query parameters such as page[number] and page[size].
For example:
GET https://apisandbox.butterflymx.com/v3/door_releases?page[size]=10&?page[number]=2
Accept: application/vnd.api+jsonSorting
Note: Examples are not url-encoded for a better readability
Example:
GET https://apisandbox.butterflymx.com/v3/door_releases?sort=name,created_at
Accept: application/vnd.api+jsonMultiple Sort You can sort on multiple fields like this:
GET https://apisandbox.butterflymx.com/v3/door_releases?sort=name,created_at
Accept: application/vnd.api+jsonDescendant Sort
Note: The sort order for each attribute is ascending unless it is prefixed with a minus (U+002D HYPHEN-MINUS, -), in which case it is descending.
You can make desc sort with the character - like this:
GET https://apisandbox.butterflymx.com/v3/door_releases?sort=-created_at
Accept: application/vnd.api+jsonMultiple Sort with Descendant Sort
GET https://apisandbox.butterflymx.com/v3/door_releases?sort=-created_at,name
Accept: application/vnd.api+jsonThe above example should return the newest door releases first. Any door release created on the same moment then be sorted by their name in ascending alphabetical order.
Filtering
Examples:
GET https://apisandbox.butterflymx.com/v3/door_releases?filter[unit]=11
Accept: application/vnd.api+jsonor
GET https://apisandbox.butterflymx.com/v3/door_releases?filter[unit]=11&filter[user]=22
Accept: application/vnd.api+jsonCheck each resource to see which fields can be filtered.
Inclusion of related resources
Some endpoints can have other resources included, check the endpoint documentation to see which resources can be included for that endpoint.
Example:
GET https://apisandbox.butterflymx.com/v3/me?include=buildings,units
Accept: application/vnd.api+jsonYou can read more about includes here
Buildings ¶
Buildings ¶
Note: symbol ✓ marks permission on all entries in the authorized scope (e.g. all buildings where the Building Admin is authorized for administration* etc.)
| List / Show | Change | Create | Delete | |
|---|---|---|---|---|
| Tenant | - | - | - | - |
| Unit Admin | - | - | - | - |
| Zone Admin | - | - | - | - |
| Building Admin | ✓ | ✓ | - | - |
Fields that can be changed by the building admin:
-
name(String) -
time_zone(String) -
building_type(String) -
display_name_strategy(String), one of the allowed values:buildingcustomfirst_name_and_last_namefirst_name_initial_and_last_nameanonymousfirst_name_and_last_name_initial
-
send_panel_status_report(Boolean) -
panel_logo(File) -
mobile_logo(File) -
remove_panel_logo(Boolean) -
remove_mobile_logo(Boolean) -
qr_key_enabled(Boolean) -
door_release_pin(String) -
in_unit_phone_number(String) -
address_1(String) -
address_2(String) -
city(String) -
state(String) -
zip_code(String) -
phone_number(String) -
country(String)
GET /v3/buildings
Requests
GET /v3/buildings
Headers
Accept: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": [
{
"id": "13",
"type": "buildings",
"attributes": {
"name": "Upton-Hahn-13",
"building_type": "multi_family",
"display_name_strategy": "last_name_and_first_name_initial",
"qr_key_enabled": true,
"nfc_enabled": false,
"send_panel_status_report": false,
"mobile_logo_picture": {
"thumb_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/thumb_small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/medium_small_picture.jpg"
},
"panel_logo_picture": {
"thumb_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/thumb_small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/medium_small_picture.jpg"
},
"address_1": "1397 Ortiz Burgs",
"address_2": "Tyberg, MA 24779",
"city": "Tyberg",
"state": "Massachusetts",
"zip_code": "24779",
"phone_number": "547.442.6681",
"country": "us",
"time_zone": "Etc/UTC",
"time_zone_offset": "+00:00",
"delivery_pass_enabled": true,
"door_release_pin": true,
"open_door_button_enabled": true
},
"relationships": {
"panels": {
"data": [
{
"id": "4",
"type": "panels"
}
]
},
"key_lockers": {
"data": []
}
}
}
],
"included": [
{
"id": "4",
"type": "panels",
"attributes": {
"name": "Cammar Pilru 4",
"nfc": {
"uuid": "50461493-6b75-4274-899f-43c2d3222e40"
}
},
"relationships": {
"building": {
"data": {
"id": "13",
"type": "buildings"
}
}
}
}
],
"links": {
"self": "http://api.butterflymx.com/v3/buildings?page%5Bnumber%5D=1&page%5Bsize%5D=20",
"first": "http://api.butterflymx.com/v3/buildings?page%5Bnumber%5D=1&page%5Bsize%5D=20",
"prev": null,
"next": null,
"last": "http://api.butterflymx.com/v3/buildings?page%5Bnumber%5D=1&page%5Bsize%5D=20"
}
}ListGET/v3/buildings
GET /v3/buildings/16
Requests
GET /v3/buildings/16
Headers
Accept: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "16",
"type": "buildings",
"attributes": {
"name": "Walter LLC-16",
"building_type": "multi_family",
"display_name_strategy": "first_name_initial_and_last_name",
"qr_key_enabled": true,
"nfc_enabled": false,
"send_panel_status_report": false,
"mobile_logo_picture": {
"thumb_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/thumb_small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/medium_small_picture.jpg"
},
"panel_logo_picture": {
"thumb_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/thumb_small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/medium_small_picture.jpg"
},
"address_1": "42933 Batz Views",
"address_2": "Linnton, MS 69200-2128",
"city": "Linnton",
"state": "Mississippi",
"zip_code": "69200-2128",
"phone_number": "(688) 129-9061 x234",
"country": "us",
"time_zone": "Etc/UTC",
"time_zone_offset": "+00:00",
"delivery_pass_enabled": true,
"door_release_pin": true,
"open_door_button_enabled": true
},
"relationships": {
"panels": {
"data": [
{
"id": "5",
"type": "panels"
}
]
},
"key_lockers": {
"data": []
}
}
},
"included": [
{
"id": "5",
"type": "panels",
"attributes": {
"name": "Miles Teg 5",
"nfc": {
"uuid": "64925b6e-c1a4-4043-94fa-98befb2926b7"
}
},
"relationships": {
"building": {
"data": {
"id": "16",
"type": "buildings"
}
}
}
}
]
}GET /v3/buildings/19?include[]=key_lockers
Headers
Accept: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "19",
"type": "buildings",
"attributes": {
"name": "Rodriguez Inc-19",
"building_type": "multi_family",
"display_name_strategy": "last_name_and_first_name_initial",
"qr_key_enabled": true,
"nfc_enabled": false,
"send_panel_status_report": false,
"mobile_logo_picture": {
"thumb_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/thumb_small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/medium_small_picture.jpg"
},
"panel_logo_picture": {
"thumb_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/thumb_small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/medium_small_picture.jpg"
},
"address_1": "6021 Quitzon Islands",
"address_2": "Abshiremouth, DE 21508",
"city": "Abshiremouth",
"state": "Delaware",
"zip_code": "21508",
"phone_number": "612-444-6522",
"country": "us",
"time_zone": "Etc/UTC",
"time_zone_offset": "+00:00",
"delivery_pass_enabled": true,
"door_release_pin": true,
"open_door_button_enabled": true
},
"relationships": {
"panels": {
"data": [
{
"id": "6",
"type": "panels"
}
]
},
"key_lockers": {
"data": [
{
"id": "1",
"type": "key_lockers"
}
]
}
}
},
"included": [
{
"id": "6",
"type": "panels",
"attributes": {
"name": "Harrah 6",
"nfc": {
"uuid": "d1113c0b-d468-45f2-a9aa-3fc8cc59e244"
}
},
"relationships": {
"building": {
"data": {
"id": "19",
"type": "buildings"
}
}
}
},
{
"id": "1",
"type": "key_lockers",
"attributes": {
"name": "Thufir Hawat 7"
},
"relationships": {
"building": {
"data": {
"id": "19",
"type": "buildings"
}
},
"compartments": {
"data": [
{
"id": "1",
"type": "key_locker_compartments"
},
{
"id": "2",
"type": "key_locker_compartments"
},
{
"id": "3",
"type": "key_locker_compartments"
},
{
"id": "4",
"type": "key_locker_compartments"
},
{
"id": "5",
"type": "key_locker_compartments"
},
{
"id": "6",
"type": "key_locker_compartments"
},
{
"id": "7",
"type": "key_locker_compartments"
},
{
"id": "8",
"type": "key_locker_compartments"
},
{
"id": "9",
"type": "key_locker_compartments"
},
{
"id": "10",
"type": "key_locker_compartments"
},
{
"id": "11",
"type": "key_locker_compartments"
},
{
"id": "12",
"type": "key_locker_compartments"
},
{
"id": "13",
"type": "key_locker_compartments"
},
{
"id": "14",
"type": "key_locker_compartments"
},
{
"id": "15",
"type": "key_locker_compartments"
},
{
"id": "16",
"type": "key_locker_compartments"
},
{
"id": "17",
"type": "key_locker_compartments"
},
{
"id": "18",
"type": "key_locker_compartments"
},
{
"id": "19",
"type": "key_locker_compartments"
}
]
}
}
},
{
"id": "1",
"type": "key_locker_compartments",
"attributes": {
"cell": "Z8",
"open": false,
"full": true
}
},
{
"id": "2",
"type": "key_locker_compartments",
"attributes": {
"cell": "A11",
"open": false,
"full": true
}
},
{
"id": "3",
"type": "key_locker_compartments",
"attributes": {
"cell": "D27",
"open": false,
"full": true
}
},
{
"id": "4",
"type": "key_locker_compartments",
"attributes": {
"cell": "W32",
"open": false,
"full": true
}
},
{
"id": "5",
"type": "key_locker_compartments",
"attributes": {
"cell": "J6",
"open": false,
"full": true
}
},
{
"id": "6",
"type": "key_locker_compartments",
"attributes": {
"cell": "X28",
"open": false,
"full": true
}
},
{
"id": "7",
"type": "key_locker_compartments",
"attributes": {
"cell": "C23",
"open": false,
"full": true
}
},
{
"id": "8",
"type": "key_locker_compartments",
"attributes": {
"cell": "T40",
"open": false,
"full": true
}
},
{
"id": "9",
"type": "key_locker_compartments",
"attributes": {
"cell": "U36",
"open": false,
"full": true
}
},
{
"id": "10",
"type": "key_locker_compartments",
"attributes": {
"cell": "Z1",
"open": false,
"full": true
}
},
{
"id": "11",
"type": "key_locker_compartments",
"attributes": {
"cell": "O22",
"open": false,
"full": true
}
},
{
"id": "12",
"type": "key_locker_compartments",
"attributes": {
"cell": "B1",
"open": false,
"full": true
}
},
{
"id": "13",
"type": "key_locker_compartments",
"attributes": {
"cell": "I11",
"open": false,
"full": true
}
},
{
"id": "14",
"type": "key_locker_compartments",
"attributes": {
"cell": "J17",
"open": false,
"full": true
}
},
{
"id": "15",
"type": "key_locker_compartments",
"attributes": {
"cell": "F15",
"open": false,
"full": true
}
},
{
"id": "16",
"type": "key_locker_compartments",
"attributes": {
"cell": "M22",
"open": false,
"full": true
}
},
{
"id": "17",
"type": "key_locker_compartments",
"attributes": {
"cell": "M30",
"open": false,
"full": true
}
},
{
"id": "18",
"type": "key_locker_compartments",
"attributes": {
"cell": "G7",
"open": false,
"full": true
}
},
{
"id": "19",
"type": "key_locker_compartments",
"attributes": {
"cell": "Z9",
"open": false,
"full": true
}
}
]
}PATCH /v3/buildings/42
Requests
PATCH /v3/buildings/42
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "buildings",
"id": "42",
"attributes": {
"name": "My Building",
"building_type": "commercial_office",
"display_name_strategy": "first_name_and_last_name",
"door_release_pin": false,
"qr_key_enabled": false,
"send_panel_status_report": true,
"time_zone": "Eastern Time (US & Canada)"
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "42",
"type": "buildings",
"attributes": {
"name": "My Building",
"building_type": "commercial_office",
"display_name_strategy": "first_name_and_last_name",
"qr_key_enabled": false,
"nfc_enabled": false,
"send_panel_status_report": true,
"mobile_logo_picture": {
"thumb_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/thumb_small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/medium_small_picture.jpg"
},
"panel_logo_picture": {
"thumb_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/thumb_small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/medium_small_picture.jpg"
},
"address_1": "628 Ratke Path",
"address_2": "Harberbury, LA 75207-4854",
"city": "Harberbury",
"state": "Louisiana",
"zip_code": "75207-4854",
"phone_number": "(803) 281-6446",
"country": "us",
"time_zone": "Eastern Time (US & Canada)",
"time_zone_offset": "-04:00",
"delivery_pass_enabled": true,
"door_release_pin": false,
"open_door_button_enabled": true
},
"relationships": {
"panels": {
"data": [
{
"id": "7",
"type": "panels"
}
]
},
"key_lockers": {
"data": []
}
}
}
}PATCH /v3/buildings/45
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "buildings",
"id": "45",
"attributes": {
"address_1": "New Building Address"
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "45",
"type": "buildings",
"attributes": {
"name": "Cremin, Lemke and Gaylord-64",
"building_type": "multi_family",
"display_name_strategy": "first_name_and_last_name_initial",
"qr_key_enabled": true,
"nfc_enabled": false,
"send_panel_status_report": false,
"mobile_logo_picture": {
"thumb_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/thumb_small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/medium_small_picture.jpg"
},
"panel_logo_picture": {
"thumb_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/thumb_small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/medium_small_picture.jpg"
},
"address_1": "New Building Address",
"address_2": "Sengertown, AR 09129",
"city": "Sengertown",
"state": "Arkansas",
"zip_code": "09129",
"phone_number": "779-880-4464",
"country": "us",
"time_zone": "Etc/UTC",
"time_zone_offset": "+00:00",
"delivery_pass_enabled": true,
"door_release_pin": true,
"open_door_button_enabled": true
},
"relationships": {
"panels": {
"data": [
{
"id": "8",
"type": "panels"
}
]
},
"key_lockers": {
"data": []
}
}
}
}PATCH /v3/buildings/48
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "buildings",
"id": "48",
"attributes": {
"address_1": ""
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"source": {
"pointer": "/data/attributes/address.address_1"
},
"detail": "can't be blank"
}
]
}PATCH /v3/buildings/51
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"remove_panel_logo": true
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "51",
"type": "buildings",
"attributes": {
"name": "Goldner-Sporer-70",
"building_type": "multi_family",
"display_name_strategy": "first_name_initial_and_last_name",
"qr_key_enabled": true,
"nfc_enabled": false,
"send_panel_status_report": false,
"mobile_logo_picture": {
"thumb_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/thumb_small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/medium_small_picture.jpg"
},
"panel_logo_picture": {
"thumb_url": "/assets/BMX_logo-950095e4e7500998fa6993f28f8950cba6f2322a76806abb7820fa39eb6394b6.png",
"medium_url": "/assets/BMX_logo-950095e4e7500998fa6993f28f8950cba6f2322a76806abb7820fa39eb6394b6.png"
},
"address_1": "5881 Divina Plains",
"address_2": "Ramiroshire, MO 86674",
"city": "Ramiroshire",
"state": "Missouri",
"zip_code": "86674",
"phone_number": "281.446.8142 x5825",
"country": "us",
"time_zone": "Etc/UTC",
"time_zone_offset": "+00:00",
"delivery_pass_enabled": true,
"door_release_pin": true,
"open_door_button_enabled": true
},
"relationships": {
"panels": {
"data": [
{
"id": "10",
"type": "panels"
}
]
},
"key_lockers": {
"data": []
}
}
}
}Integrations ¶
Integrations
Allowed integrators:
webhook
Allowed config attributes for integrators:
- webhook
- url (String)
- method (String
getorpost)
Allowed binding resource types:
-
call -
door_release
GET /v3/buildings/1337/integrations
Requests
GET /v3/buildings/1337/integrations
Headers
Accept: application/vnd.api+json
Content-Type: application/jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": [
{
"id": "79c9dc15-1bef-4ecc-956e-824be46901ce",
"type": "integrations",
"attributes": {
"integrator": "webhook",
"config": {
"method": "get",
"url": "http://localhost:999"
},
"bindings": [
{
"resource_type": "door_release",
"resource_id": "7",
"actions": [
"update",
"destroy"
]
}
]
},
"relationships": {
"bindings": {
"data": [
{
"resource_type": "door_release",
"resource_id": "7",
"actions": [
"update",
"destroy"
]
}
]
},
"building": {
"data": {
"id": "1337",
"type": "buildings"
}
},
"tenant": {
"data": null
}
},
"links": {
"self": "http://api.butterflymx.com/v3/buildings/1337/integrations/79c9dc15-1bef-4ecc-956e-824be46901ce"
}
}
],
"links": {
"self": "http://api.butterflymx.com/v3/buildings/1337/integrations?page%5Bnumber%5D=1&page%5Bsize%5D=10",
"first": "http://api.butterflymx.com/v3/buildings/1337/integrations?page%5Bnumber%5D=1&page%5Bsize%5D=10",
"prev": null,
"next": null,
"last": "http://api.butterflymx.com/v3/buildings/1337/integrations?page%5Bnumber%5D=1&page%5Bsize%5D=10"
}
}ListGET/v3/buildings/{building_id}/integrations
URI Parameters
- building_id
number(required) Example: 1337
GET /v3/buildings/1337/integrations/79c9dc15-1bef-4ecc-956e-824be46901ce
Requests
GET /v3/buildings/1337/integrations/79c9dc15-1bef-4ecc-956e-824be46901ce
Headers
Accept: application/vnd.api+json
Content-Type: application/jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "79c9dc15-1bef-4ecc-956e-824be46901ce",
"type": "integrations",
"attributes": {
"integrator": "webhook",
"config": {
"method": "get",
"url": "http://localhost:999"
},
"bindings": [
{
"resource_type": "door_release",
"resource_id": "7",
"actions": [
"update",
"destroy"
]
}
]
},
"relationships": {
"bindings": {
"data": [
{
"resource_type": "door_release",
"resource_id": "7",
"actions": [
"update",
"destroy"
]
}
]
},
"building": {
"data": {
"id": "1337",
"type": "buildings"
}
},
"tenant": {
"data": null
}
},
"links": {
"self": "http://api.butterflymx.com/v3/buildings/1337/integrations/79c9dc15-1bef-4ecc-956e-824be46901ce"
}
}
}ShowGET/v3/buildings/{building_id}/integrations/{id}
URI Parameters
- building_id
number(required) Example: 1337- id
string(required) Example: 79c9dc15-1bef-4ecc-956e-824be46901ce
POST /v3/buildings/1337/integrations
Requests
POST /v3/buildings/1337/integrations
Headers
Accept: application/vnd.api+json
Content-Type: application/jsonBody
{
"data": {
"type": "integrations",
"attributes": {
"integrator": "webhook",
"configuration": {
"url": "http://localhost:666",
"method": "post"
},
"bindings": [
{
"actions": [
"create"
],
"resource_type": "call",
"resource_id": null
}
]
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "79c9dc15-1bef-4ecc-956e-824be46901ce",
"type": "integrations",
"attributes": {
"integrator": "webhook",
"config": {
"method": "post",
"url": "http://localhost:666"
},
"bindings": [
{
"resource_type": "call",
"resource_id": null,
"actions": [
"create"
]
}
]
},
"relationships": {
"bindings": {
"data": [
{
"resource_type": "call",
"resource_id": null,
"actions": [
"create"
]
}
]
},
"building": {
"data": {
"id": "1337",
"type": "buildings"
}
},
"tenant": {
"data": null
}
},
"links": {
"self": "http://api.butterflymx.com/v3/buildings/1337/integrations/79c9dc15-1bef-4ecc-956e-824be46901ce"
}
}
}CreatePOST/v3/buildings/{building_id}/integrations
URI Parameters
- building_id
number(required) Example: 1337
PATCH /v3/buildings/1337/integrations/79c9dc15-1bef-4ecc-956e-824be46901ce
Requests
PATCH /v3/buildings/1337/integrations/79c9dc15-1bef-4ecc-956e-824be46901ce
Headers
Accept: application/vnd.api+json
Content-Type: application/jsonBody
{
"data": {
"type": "integrations",
"attributes": {
"integrator": "webhook",
"configuration": {
"url": "http://localhost:999",
"method": "get"
},
"bindings": [
{
"actions": [
"update",
"destroy"
],
"resource_type": "door_release",
"resource_id": "7"
}
]
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "79c9dc15-1bef-4ecc-956e-824be46901ce",
"type": "integrations",
"attributes": {
"integrator": "webhook",
"config": {
"method": "get",
"url": "http://localhost:999"
},
"bindings": [
{
"resource_type": "door_release",
"resource_id": "7",
"actions": [
"update",
"destroy"
]
}
]
},
"relationships": {
"bindings": {
"data": [
{
"resource_type": "door_release",
"resource_id": "7",
"actions": [
"update",
"destroy"
]
}
]
},
"building": {
"data": {
"id": "1337",
"type": "buildings"
}
},
"tenant": {
"data": null
}
},
"links": {
"self": "http://api.butterflymx.com/v3/buildings/1337/integrations/79c9dc15-1bef-4ecc-956e-824be46901ce"
}
}
}UpdatePATCH/v3/buildings/{building_id}/integrations/{id}
URI Parameters
- building_id
number(required) Example: 1337- id
string(required) Example: 79c9dc15-1bef-4ecc-956e-824be46901ce
DELETE /v3/buildings/1337/integrations/79c9dc15-1bef-4ecc-956e-824be46901ce
Requests
DELETE /v3/buildings/1337/integrations/79c9dc15-1bef-4ecc-956e-824be46901ce
Headers
Accept: application/vnd.api+json
Content-Type: application/jsonResponses
This response has no content.
DeleteDELETE/v3/buildings/{building_id}/integrations/{id}
URI Parameters
- building_id
number(required) Example: 1337- id
string(required) Example: 79c9dc15-1bef-4ecc-956e-824be46901ce
Current User ¶
Status ¶
Possible status values:
When call is VOIP:
-
initializing -
canceled -
timeout_online_signal -
voip_connected
When call is mobile:
-
initializing -
canceled -
timeout_online_signal -
connecting_sip -
voip_rollover -
rejected
GET /v3/me/calls/5f1e441b-6e0e-42d8-a9ad-d7689b704c34/status
Requests
GET /v3/me/calls/5f1e441b-6e0e-42d8-a9ad-d7689b704c34/status
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "2",
"type": "call_statuses",
"attributes": {
"status": "initializing",
"multiple_devices": false,
"created_at": "2022-09-29T09:07:02Z"
},
"relationships": {
"call": {
"data": {
"id": "1",
"type": "calls"
}
}
}
},
"included": [
{
"id": "1",
"type": "calls",
"attributes": {
"guid": "5f1e441b-6e0e-42d8-a9ad-d7689b704c34",
"call_type": "voip",
"notification_type": "visitor",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"created_at": "2022-09-29T09:03:55Z",
"logged_at": "2022-09-29T09:03:55Z",
"status": "initializing",
"display_status": "Initializing",
"panel_id": 11,
"panel_name": "Scytale 31",
"panel_sip": "panel_11",
"provider": "internal"
}
}
]
}GET /v3/me/calls/DOES_NOT_EXIST/status
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"title": "Record not found",
"detail": "Requested record could not be found"
}
]
}Call StatusGET/v3/me/calls/{call_guid}/status
URI Parameters
- call_guid
string(required) Example: 5f1e441b-6e0e-42d8-a9ad-d7689b704c34
Calls ¶
Sortable fields:
-
created_at
-
logged_at
-
notification_type
-
call_type
Filterable fields:
-
unit -> integer -
notification_type -> enum(string) -
call_type -> enum(string) -
guid -> string
Enumerations:
-
call_type:
- voip
- mobile
-
notification_type:
- visitor
- delivery
GET /v3/me/calls
Requests
GET /v3/me/calls
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": [
{
"id": "5",
"type": "calls",
"attributes": {
"guid": "8da16784-bf47-4c0c-a1fb-96cb87188ef7",
"call_type": "voip",
"notification_type": "visitor",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"created_at": "2022-09-29T09:03:55Z",
"logged_at": "2022-09-29T09:03:55Z",
"status": "initializing",
"display_status": "Initializing",
"initial": true,
"provider": "internal"
},
"relationships": {
"rollover_calls": {
"data": []
},
"panel": {
"data": {
"id": "13",
"type": "panels"
}
}
}
},
{
"id": "4",
"type": "calls",
"attributes": {
"guid": "cdd7a919-9355-4734-88c1-7166adfcf4b7",
"call_type": "voip",
"notification_type": "visitor",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"created_at": "2022-09-29T09:03:55Z",
"logged_at": "2022-09-29T09:03:55Z",
"status": "initializing",
"display_status": "Initializing",
"initial": true,
"provider": "internal"
},
"relationships": {
"rollover_calls": {
"data": []
},
"panel": {
"data": {
"id": "13",
"type": "panels"
}
}
}
},
{
"id": "3",
"type": "calls",
"attributes": {
"guid": "d3008440-16b8-486c-92c6-567876e01cc6",
"call_type": "voip",
"notification_type": "visitor",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"created_at": "2022-09-29T09:03:55Z",
"logged_at": "2022-09-29T09:03:55Z",
"status": "initializing",
"display_status": "Initializing",
"initial": true,
"provider": "internal"
},
"relationships": {
"rollover_calls": {
"data": []
},
"panel": {
"data": {
"id": "13",
"type": "panels"
}
}
}
}
],
"links": {
"self": "http://api.butterflymx.com/v3/me/calls?page%5Bnumber%5D=1&page%5Bsize%5D=20",
"first": "http://api.butterflymx.com/v3/me/calls?page%5Bnumber%5D=1&page%5Bsize%5D=20",
"prev": null,
"next": null,
"last": "http://api.butterflymx.com/v3/me/calls?page%5Bnumber%5D=1&page%5Bsize%5D=20"
}
}CallsGET/v3/me/calls
Door Releases ¶
Sortable fields:
-
created_at
-
logged_at
-
notification_type
-
call_type
Filterable fields:
-
unit -> integer -
release_method -> enum -
door_release_type -> enum -
name -> string -
call_guid -> string
Enumerations:
-
release_method:
- mobile
- panel
- qr_key
- nfc
- voip
- bluetooth
- front_door_view
- rfid
-
door_release_type:
- visitor
- delivery
GET /v3/me/door_releases
Requests
GET /v3/me/door_releases
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": [
{
"id": "6",
"type": "door_releases",
"attributes": {
"release_method": "mobile",
"door_release_type": "visitor",
"call_guid": "a35d5e22-8435-434b-8675-da2b798aaa57",
"delivery_guid": "308dfc72-8392-4665-8098-62e1f2cccd3a",
"name": "Yaeko Feil",
"thumb_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/thumb/small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/medium/small_picture.jpg",
"created_at": "2022-09-29T09:03:55Z",
"logged_at": "2022-09-29T09:03:55Z"
},
"relationships": {
"unit": {
"data": {
"id": "81",
"type": "units"
}
},
"user": {
"data": {
"id": "24",
"type": "users"
}
},
"panel": {
"data": {
"id": "14",
"type": "panels"
}
},
"device": {
"data": {
"id": "17",
"type": "panels"
}
}
}
},
{
"id": "5",
"type": "door_releases",
"attributes": {
"release_method": "mobile",
"door_release_type": "visitor",
"call_guid": "35021739-6cbc-437d-84b0-927799d3b90f",
"delivery_guid": "7bacbf11-6a1f-448f-805b-346acb30859f",
"name": "Dr. Tyree Waelchi",
"thumb_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/thumb/small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/medium/small_picture.jpg",
"created_at": "2022-09-29T09:03:55Z",
"logged_at": "2022-09-29T09:03:55Z"
},
"relationships": {
"unit": {
"data": {
"id": "81",
"type": "units"
}
},
"user": {
"data": {
"id": "24",
"type": "users"
}
},
"panel": {
"data": {
"id": "14",
"type": "panels"
}
},
"device": {
"data": {
"id": "16",
"type": "panels"
}
}
}
},
{
"id": "4",
"type": "door_releases",
"attributes": {
"release_method": "mobile",
"door_release_type": "visitor",
"call_guid": "b96a3c6c-3eeb-4974-8705-71ef61bcd355",
"delivery_guid": "557d9e07-6165-4130-9c16-a4d45a6dcf3d",
"name": "Doreen Goodwin",
"thumb_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/thumb/small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/medium/small_picture.jpg",
"created_at": "2022-09-29T09:03:55Z",
"logged_at": "2022-09-29T09:03:55Z"
},
"relationships": {
"unit": {
"data": {
"id": "81",
"type": "units"
}
},
"user": {
"data": {
"id": "24",
"type": "users"
}
},
"panel": {
"data": {
"id": "14",
"type": "panels"
}
},
"device": {
"data": {
"id": "15",
"type": "panels"
}
}
}
}
],
"links": {
"self": "http://api.butterflymx.com/v3/me/door_releases?page%5Bnumber%5D=1&page%5Bsize%5D=20",
"first": "http://api.butterflymx.com/v3/me/door_releases?page%5Bnumber%5D=1&page%5Bsize%5D=20",
"prev": null,
"next": null,
"last": "http://api.butterflymx.com/v3/me/door_releases?page%5Bnumber%5D=1&page%5Bsize%5D=20"
}
}Door ReleasesGET/v3/me/door_releases
Messages ¶
Sortable fields:
-
message_type
-
created_at
Filterable fields:
message_type -> enum
Enumerations:
- message_type:
- text
- voice
GET /v3/me/messages
Requests
GET /v3/me/messages
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": [
{
"id": "3",
"type": "messages",
"attributes": {
"message": null,
"voice": {
"url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/voice_message.mp3"
},
"message_type": "voice"
}
},
{
"id": "2",
"type": "messages",
"attributes": {
"message": null,
"voice": {
"url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/voice_message.mp3"
},
"message_type": "voice"
}
},
{
"id": "1",
"type": "messages",
"attributes": {
"message": null,
"voice": {
"url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/voice_message.mp3"
},
"message_type": "voice"
}
}
],
"links": {
"self": "http://api.butterflymx.com/v3/me/messages?page%5Bnumber%5D=1&page%5Bsize%5D=20",
"first": "http://api.butterflymx.com/v3/me/messages?page%5Bnumber%5D=1&page%5Bsize%5D=20",
"prev": null,
"next": null,
"last": "http://api.butterflymx.com/v3/me/messages?page%5Bnumber%5D=1&page%5Bsize%5D=20"
}
}MessagesGET/v3/me/messages
Open Door ¶
POST /v3/me/open_door
Requests
POST /v3/me/open_door
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {},
"type": "open_door",
"relationships": {
"panel": {
"data": {
"type": "panel",
"id": 18
}
},
"unit": {
"data": {
"type": "unit",
"id": 91
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "1",
"type": "door_release_requests",
"attributes": {
"guid": "6030c8d2-56f6-4ebb-8e86-9f297c49ff42",
"created_at": "2022-09-29T09:07:04Z"
}
}
}POST /v3/me/open_door
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {},
"type": "open_door",
"relationships": {
"unit": {
"data": {
"type": "unit",
"id": 93
}
},
"device": {
"data": {
"type": "keypads",
"id": 1
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "2",
"type": "door_release_requests",
"attributes": {
"guid": "73a07839-701c-419a-a6a4-970aa5148172",
"created_at": "2022-09-29T09:07:05Z"
}
}
}POST /v3/me/open_door
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {},
"type": "open_doors",
"relationships": {
"panels": {
"data": {
"type": "panels",
"id": "DOES_NOT_EXIST"
}
},
"unit": {
"data": {
"type": "unit",
"id": 96
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"source": {
"pointer": "/data/attributes/device"
},
"detail": "must exist"
},
{
"source": {
"pointer": "/data/attributes/building_open_door_button"
},
"detail": "Building open door feature has not been enabled"
},
{
"source": {
"pointer": "/data/attributes/release_method"
},
"detail": "disabled for this device"
}
]
}Open DoorPOST/v3/me/open_door
Tokens ¶
POST /v3/me/calls/twiliotest/token
Requests
POST /v3/me/calls/twiliotest/token
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"device_uuid": "test-123-test"
},
"type": "token",
"relationships": null
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"tokens": {
"twilio": "token-12345679-token"
}
}POST /v3/me/calls/twiliotest/token
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"device_uuid": "test-123-test"
},
"type": "token",
"relationships": null
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"tokens": {
"twilio": "token-12345679-token"
}
}POST /v3/me/calls/voiptest/token
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"device_uuid": "test-123-test"
},
"type": "token",
"relationships": null
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"error": "Bad Request",
"error_description": "Token was not generated"
}CreatePOST/v3/me/calls/{call_guid}/token
URI Parameters
- call_guid
string(required) Example: twiliotest
User ¶
Resources that can be included:
- tenants
Nested resources that can be included:
-
tenants.building
-
tenants.unit
-
tenants.panels
GET /v3/me
Requests
GET /v3/me
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "32",
"type": "users",
"attributes": {
"name": "Nancy Schumm",
"first_name": "Nancy",
"last_name": "Schumm",
"contact_preference": "phone_call",
"thumb_url": null,
"medium_url": null,
"sip_username": "32",
"email": "mckinley@stoltenbergjohnson.net",
"sms_phone_number": null,
"phone_number": null
},
"relationships": {
"tenants": {
"data": [
{
"id": "39",
"type": "tenants"
}
]
}
}
}
}GET /v3/me?include=tenants.building,tenants.panels,tenants.unit
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "33",
"type": "users",
"attributes": {
"name": "Otto Hilpert",
"first_name": "Otto",
"last_name": "Hilpert",
"contact_preference": "phone_call",
"thumb_url": null,
"medium_url": null,
"sip_username": "33",
"email": "eldridge_schaefer@volkman.co",
"sms_phone_number": null,
"phone_number": null
},
"relationships": {
"tenants": {
"data": [
{
"id": "40",
"type": "tenants"
}
]
}
}
},
"included": [
{
"id": "40",
"type": "tenants",
"attributes": {
"unit_id": 115,
"inactive_at": null
},
"relationships": {
"building": {
"data": {
"id": "90",
"type": "buildings"
}
},
"unit": {
"data": {
"id": "115",
"type": "units"
}
},
"panels": {
"data": [
{
"id": "28",
"type": "panels"
}
]
},
"devices": {
"data": []
}
}
},
{
"id": "90",
"type": "buildings",
"attributes": {
"name": "Jast-Franecki-109",
"building_type": "multi_family",
"mobile_logo_picture": {
"thumb_url": "/assets/BMX_logo-950095e4e7500998fa6993f28f8950cba6f2322a76806abb7820fa39eb6394b6.png",
"medium_url": "/assets/BMX_logo-950095e4e7500998fa6993f28f8950cba6f2322a76806abb7820fa39eb6394b6.png"
},
"panel_logo_picture": {
"thumb_url": "/assets/BMX_logo-950095e4e7500998fa6993f28f8950cba6f2322a76806abb7820fa39eb6394b6.png",
"medium_url": "/assets/BMX_logo-950095e4e7500998fa6993f28f8950cba6f2322a76806abb7820fa39eb6394b6.png"
},
"address_1": "491 Mitchell Unions",
"address_2": "Rempelstad, NM 35820-4151",
"city": "Rempelstad",
"state": "New Mexico",
"zip_code": "35820-4151",
"phone_number": "351-410-9515",
"country": "us",
"time_zone": "Etc/UTC",
"open_door_button_enabled": true
}
},
{
"id": "115",
"type": "units",
"attributes": {
"kind": "residential",
"label": "00",
"floor_number": 0
}
},
{
"id": "28",
"type": "panels",
"attributes": {
"name": "Liet-Kynes 50",
"nfc": {
"uuid": "634a5f92-4b96-4897-b688-dfe050419280"
}
}
}
]
}ShowGET/v3/me
PUT /v3/me
Requests
PUT /v3/me
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "tenants",
"id": "34",
"attributes": {
"last_name": "Baker"
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "34",
"type": "users",
"attributes": {
"name": "Vashti Baker",
"first_name": "Vashti",
"last_name": "Baker",
"contact_preference": "phone_call",
"thumb_url": null,
"medium_url": null,
"sip_username": "34",
"email": "casey.emard@boehmoconnell.com",
"sms_phone_number": null,
"phone_number": null
},
"relationships": {
"tenants": {
"data": [
{
"id": "41",
"type": "tenants"
}
]
}
}
}
}PUT /v3/me
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "tenants",
"id": "35",
"attributes": {
"last_name": ""
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"error": "Bad Request",
"error_description": "Last name can't be blank"
}UpdatePUT/v3/me
Devices ¶
Devices ¶
Fetch a list of devices that the authorized user has access to.
-
If a user is a tenant, only door devices that are installed, enabled and where he has access to are included.
-
If a user is an admin, a list of all devices from all buildings the user has access will be included.
Building id is included in relationships, and detailed building info can be requested with ?include=building parameter
GET /v3/devices
Requests
GET /v3/devices?include=building
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": []
}ListGET/v3/devices
Door Releases ¶
Door Releases ¶
Note: symbol ✓ marks permission on all entries in the authorized scope (e.g. all buildings where the Building Admin is authorized for administration* etc.)
| List / Show | Change | Create | Delete | |
|---|---|---|---|---|
| Tenant | ✓ | - | - | - |
| Unit Admin | ✓ | - | - | - |
| Zone Admin | ✓ | - | - | - |
| Building Admin | ✓ | - | - | - |
Request Samples with Filter:
GET /v3/door_releases?unit_id=11
GET /v3/door_releases?user_id=22
GET /v3/door_releases?unit_id=11&user_id=22
GET /v3/door_releases?door_release_type=delivery
Request Samples with Sort:
GET /v3/door_releases?sort=created
GET /v3/door_releases?sort=-created,name
The sort order for each attribute is ascending unless it is prefixed with a minus (U+002D HYPHEN-MINUS, “-“), in which case it is descending.
Allowed values for:
-
release_method:mobilepanelqr_keynfcvoip
-
door_release_type:visitordelivery
-
panel_user_type:defaultdoorman
GET /v3/door_releases
Requests
GET /v3/door_releases
Headers
Accept: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": [
{
"id": "32",
"type": "door_releases",
"attributes": {
"release_method": "mobile",
"door_release_type": "visitor",
"panel_user_type": "doorman",
"call_guid": "71bc4029-9fbb-4aa6-8254-b54804b68a5e",
"delivery_guid": "e6995d44-a0e0-434c-b467-e7f0b1381882",
"name": "Miss Darin Goodwin",
"created_at": "2022-09-29T09:03:55Z",
"logged_at": "2022-09-29T09:03:55Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "48",
"type": "users"
}
},
"panel": {
"data": {
"id": "41",
"type": "panels"
}
},
"device": {
"data": {
"id": "41",
"type": "panels"
}
}
}
},
{
"id": "31",
"type": "door_releases",
"attributes": {
"release_method": "mobile",
"door_release_type": "visitor",
"panel_user_type": "doorman",
"call_guid": "922d8f2e-b1d1-4288-a232-b935cca4e872",
"delivery_guid": "c6fbd004-aa9b-4e6a-a4bf-ea095285c2f5",
"name": "Harrison Larson",
"created_at": "2022-09-29T09:03:55Z",
"logged_at": "2022-09-29T09:03:55Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "48",
"type": "users"
}
},
"panel": {
"data": {
"id": "41",
"type": "panels"
}
},
"device": {
"data": {
"id": "41",
"type": "panels"
}
}
}
},
{
"id": "30",
"type": "door_releases",
"attributes": {
"release_method": "mobile",
"door_release_type": "visitor",
"panel_user_type": "default",
"call_guid": "29ff9231-76a1-4a4f-aaeb-a3816b018e26",
"delivery_guid": "563427d1-bf9e-4d3b-a28b-9ff152f4e10f",
"name": "Tommie Cremin",
"created_at": "2022-09-29T09:03:55Z",
"logged_at": "2022-09-29T09:03:55Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "48",
"type": "users"
}
},
"panel": {
"data": {
"id": "41",
"type": "panels"
}
},
"device": {
"data": {
"id": "41",
"type": "panels"
}
}
}
},
{
"id": "29",
"type": "door_releases",
"attributes": {
"release_method": "mobile",
"door_release_type": "visitor",
"panel_user_type": "default",
"call_guid": "9862d75d-e030-42fa-96ed-629afda8a20e",
"delivery_guid": "903d5310-7c74-4a36-b02e-ffbfac3aa3a1",
"name": "Tristan Carroll",
"created_at": "2022-09-29T09:03:55Z",
"logged_at": "2022-09-29T09:03:55Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "48",
"type": "users"
}
},
"panel": {
"data": {
"id": "41",
"type": "panels"
}
},
"device": {
"data": {
"id": "41",
"type": "panels"
}
}
}
},
{
"id": "28",
"type": "door_releases",
"attributes": {
"release_method": "mobile",
"door_release_type": "delivery",
"panel_user_type": "default",
"call_guid": "bcb39027-ef24-4b86-b0a1-084dd83bc4dd",
"delivery_guid": "01767fe8-18e6-45de-87f2-5b9f1f213601",
"name": "Seymour Goyette",
"created_at": "2022-09-29T09:03:55Z",
"logged_at": "2022-09-29T09:03:55Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "48",
"type": "users"
}
},
"panel": {
"data": {
"id": "41",
"type": "panels"
}
},
"device": {
"data": {
"id": "41",
"type": "panels"
}
}
}
},
{
"id": "27",
"type": "door_releases",
"attributes": {
"release_method": "mobile",
"door_release_type": "delivery",
"panel_user_type": "default",
"call_guid": "8861bd83-df58-4ce2-a7b2-707ea92025fd",
"delivery_guid": "7d1b45ee-0067-4890-9a89-415c7690e19e",
"name": "Marica Trantow",
"created_at": "2022-09-29T09:03:55Z",
"logged_at": "2022-09-29T09:03:55Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "48",
"type": "users"
}
},
"panel": {
"data": {
"id": "41",
"type": "panels"
}
},
"device": {
"data": {
"id": "41",
"type": "panels"
}
}
}
},
{
"id": "26",
"type": "door_releases",
"attributes": {
"release_method": "mobile",
"door_release_type": "visitor",
"panel_user_type": "default",
"call_guid": "807f9f20-5fb3-4837-ab2d-c2e903d80492",
"delivery_guid": "935b3b0d-40d4-450b-a4fa-088221b92934",
"name": "Barbara Botsford",
"created_at": "2022-09-29T09:03:55Z",
"logged_at": "2022-09-29T09:03:55Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "48",
"type": "users"
}
},
"panel": {
"data": {
"id": "41",
"type": "panels"
}
},
"device": {
"data": {
"id": "41",
"type": "panels"
}
}
}
},
{
"id": "25",
"type": "door_releases",
"attributes": {
"release_method": "mobile",
"door_release_type": "visitor",
"panel_user_type": "default",
"call_guid": "077dbd49-c40b-4a85-9af4-08f865c35d57",
"delivery_guid": "0ed76ef8-a666-4ba7-a30d-267b3e39081c",
"name": "Nathanael Hermiston",
"created_at": "2022-09-29T09:03:55Z",
"logged_at": "2022-09-29T09:03:55Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "48",
"type": "users"
}
},
"panel": {
"data": {
"id": "41",
"type": "panels"
}
},
"device": {
"data": {
"id": "41",
"type": "panels"
}
}
}
},
{
"id": "24",
"type": "door_releases",
"attributes": {
"release_method": "qr_key",
"door_release_type": "visitor",
"panel_user_type": "default",
"call_guid": "afd530a6-d21a-431d-878a-0918367b06fa",
"delivery_guid": "246fdc56-5cd5-4acb-9b5c-e15a93189b1b",
"name": "Darin Wisozk",
"created_at": "2022-09-29T09:03:55Z",
"logged_at": "2022-09-29T09:03:55Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "48",
"type": "users"
}
},
"panel": {
"data": {
"id": "41",
"type": "panels"
}
},
"device": {
"data": {
"id": "41",
"type": "panels"
}
}
}
},
{
"id": "23",
"type": "door_releases",
"attributes": {
"release_method": "qr_key",
"door_release_type": "visitor",
"panel_user_type": "default",
"call_guid": "5165d376-bd9f-458e-ad1c-7887a856ae7d",
"delivery_guid": "e0d4d58c-0a9e-4d52-ac75-ecf1b5cb64d5",
"name": "Xavier Hauck IV",
"created_at": "2022-09-29T09:03:55Z",
"logged_at": "2022-09-29T09:03:55Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "48",
"type": "users"
}
},
"panel": {
"data": {
"id": "41",
"type": "panels"
}
},
"device": {
"data": {
"id": "41",
"type": "panels"
}
}
}
},
{
"id": "22",
"type": "door_releases",
"attributes": {
"release_method": "mobile",
"door_release_type": "visitor",
"panel_user_type": "default",
"call_guid": "707e636d-7ed1-4b20-85cc-1f137456fcfe",
"delivery_guid": "a41e1333-37ae-4443-84f5-aac7e18b8fd5",
"name": "Vicente Mante Sr.",
"created_at": "2022-09-29T09:03:55Z",
"logged_at": "2022-09-29T09:03:55Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "48",
"type": "users"
}
},
"panel": {
"data": {
"id": "41",
"type": "panels"
}
},
"device": {
"data": {
"id": "41",
"type": "panels"
}
}
}
},
{
"id": "21",
"type": "door_releases",
"attributes": {
"release_method": "mobile",
"door_release_type": "visitor",
"panel_user_type": "default",
"call_guid": "a5b86fba-1c77-43c0-be18-8edb82f6edd3",
"delivery_guid": "f39dc4b5-c85d-4e96-894b-7ed746cf8eae",
"name": "Vanesa Kunde",
"created_at": "2022-09-29T09:03:55Z",
"logged_at": "2022-09-29T09:03:55Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "48",
"type": "users"
}
},
"panel": {
"data": {
"id": "41",
"type": "panels"
}
},
"device": {
"data": {
"id": "41",
"type": "panels"
}
}
}
},
{
"id": "20",
"type": "door_releases",
"attributes": {
"release_method": "mobile",
"door_release_type": "visitor",
"panel_user_type": "default",
"call_guid": "0bf16a57-75e4-484d-af60-eeea07416075",
"delivery_guid": "e55d955b-bc0e-461e-a662-5ee7fa6c845d",
"name": "Elton Nienow",
"created_at": "2022-09-29T09:03:55Z",
"logged_at": "2022-09-29T09:03:55Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "48",
"type": "users"
}
},
"panel": {
"data": null
},
"device": {
"data": {
"id": "3",
"type": "keypads"
}
}
}
},
{
"id": "19",
"type": "door_releases",
"attributes": {
"release_method": "mobile",
"door_release_type": "visitor",
"panel_user_type": "default",
"call_guid": "d378c340-9317-4f70-868f-38029f282a60",
"delivery_guid": "c7fa1687-beaf-4faf-b586-f07ae3147894",
"name": "Angila Bogan",
"created_at": "2022-09-29T09:03:55Z",
"logged_at": "2022-09-29T09:03:55Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "48",
"type": "users"
}
},
"panel": {
"data": null
},
"device": {
"data": {
"id": "3",
"type": "keypads"
}
}
}
}
],
"links": {
"self": "http://api.butterflymx.com/v3/door_releases?page%5Bnumber%5D=1&page%5Bsize%5D=20",
"first": "http://api.butterflymx.com/v3/door_releases?page%5Bnumber%5D=1&page%5Bsize%5D=20",
"prev": null,
"next": null,
"last": "http://api.butterflymx.com/v3/door_releases?page%5Bnumber%5D=1&page%5Bsize%5D=20"
}
}ListGET/v3/door_releases
Keychains ¶
Keychains ¶
How to Create a Keychain with Virtual Keys
We use two concepts when creating a virtual key:
-
Keychain
-
Virtual Key
Keychain
Keychain contains information about the kind of key, what its duration is etc. A keychain can have many virtual keys, so a single keychain can be used to create virtual keys for multiple people. Information from the keychain is used by the panels to verify if the virtual key is still valid. Keychains must be associated with a unit.
Parameters that are always required for all keychains:
name -> string
tenant -> relationship or unit -> relationship
If you wish to have the keychain associated with tenant send the tenant relationship, otherwise send the unit as relationship. The second case is useful if you have large tenant turnover in a unit (e.g short term tourist renals). If you wish to allow your tenants to create and share keys by themselves, tenant association is required.
Custom keychains
Custom keychains have a start and end date when they are valid e.g. a virtual key for a custom keychain will be valid from 01/01/2019 11:50 to 03/03/2019 13:45. Always use the iso8601 format when sending datetime data.
Parameters that are required for custom keychains:
starts_at -> datetime (iso8601)
ends_at -> datetime (iso8601)
Recurring keychains
Recurring keychains are valid only on certain weekdays and inside certain time periods e.g. a virtual key for a recurring keychain will be valid only on wednesdays and thursdays between 12:30 and 16:30. Recurring keychains also use the start and end dates to determine when they will completely expired, so if a recurring keychain has an end date on 03/03/2019 the above virtual key will no longer be valid on wendesdays and thursdays. Always use the iso8601 format when sending datetime data, for time data use the hh:mm format (06:21, 11:53, 22:51).
Parameters that are required for custom keychains:
weekdays -> array(enum)
start_date -> date (iso8601)
end_date -> date (iso8601)
time_to -> time (hh:mm)
time_from -> time (hh:mm)
Enumerations:
- weekdays:
- mon
- tue
- wed
- thu
- fri
- sat
- sun
One time keychains
Virtual keys that belong to one time keychains can be used only once inside a predefined period of tim, which is determined by starts_at and ends_at fields. After they are used or if they’re not inside a predefined period of time they are no longer valid e.g. if a keychain’s validity period is from 01/01/2019 11:50 to 03/03/2019 13:45, it will not be valid if it’s used inside that period or when the time of 03/03/2019 13:45 has passed.
To determine if a particular virtual key for the one time keychain, or delivery pass has been used, check the used_at, one_time_key_used_at field on the virtual key.
Parameters that are required for one time keychains:
starts_at -> datetime (iso8601)
ends_at -> datetime (iso8601)
Virtual Key
Virtual key is used by a single person to open a door, it contains either an e-mail or an sms number of the person who will use it, a url to the qr code of the key which can be scanned to gain access to the building and a name which is used when the key is sent to the user.
Virtual keys are created from an array of recipients (e-mail or a mobile phone number) that is added to keychain parameters or on a separate endpoint.
Parameters that are required to create virtual keys:
recipients -> array(string)
Filterable fields:
-
unit -> integer -
tenant -> integer
POST /v3/keychains/custom
Requests
POST /v3/keychains/custom
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"name": "Custom Key",
"starts_at": "2022-09-29T09:07:15+00:00",
"ends_at": "2022-10-01T09:07:10+00:00",
"recipients": [
"test@example.com",
"+12345678901"
]
},
"type": "keychains",
"relationships": {
"unit": {
"data": {
"type": "unit",
"id": 139
}
},
"devices": {
"data": [
{
"type": "keypads",
"id": 2
}
]
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "15",
"type": "keychains",
"attributes": {
"name": "Custom Key",
"weekdays": [],
"starts_at": "2022-09-29T09:07:15Z",
"ends_at": "2022-10-01T09:07:10Z",
"time_from": "09:07",
"time_to": "09:07",
"kind": "custom",
"start_date": "2022-09-29",
"end_date": "2022-10-01",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": [
{
"id": "7",
"type": "virtual_keys"
},
{
"id": "8",
"type": "virtual_keys"
}
]
},
"devices": {
"data": [
{
"id": "2",
"type": "keypads"
},
{
"id": "2",
"type": "keypads"
}
]
}
}
},
"included": [
{
"id": "7",
"type": "virtual_keys",
"attributes": {
"name": "Custom Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-1ogf3ay.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "377031",
"instructions_url": "http://user.butterflymx.test/public/jaskolski-ryan-and-vonrueden-133/virtual_keys/7/85a0815518af34f9a9d152d7ab9c7a01",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
},
{
"id": "8",
"type": "virtual_keys",
"attributes": {
"name": "Custom Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-gy1sps.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "316339",
"instructions_url": "http://user.butterflymx.test/public/jaskolski-ryan-and-vonrueden-133/virtual_keys/8/0de3ba7d26f902f5e4382f3943847b98",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
},
{
"id": "2",
"type": "keypads",
"attributes": {
"name": "Gaius Helen Mohiam 62"
},
"relationships": {
"building": {
"data": {
"id": "114",
"type": "buildings"
}
}
}
}
]
}POST /v3/keychains/custom
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"name": "Custom Key",
"starts_at": "2022-09-29T09:07:17+00:00",
"ends_at": "2022-10-01T09:07:12+00:00",
"recipients": [
"test@example.com",
"+12345678901"
],
"key_locker": {
"id": 2,
"compartment": "C37"
}
},
"type": "keychains",
"relationships": {
"unit": {
"data": {
"type": "unit",
"id": 141
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "16",
"type": "keychains",
"attributes": {
"name": "Custom Key",
"weekdays": [],
"starts_at": "2022-09-29T09:07:17Z",
"ends_at": "2022-10-01T09:07:12Z",
"time_from": "09:07",
"time_to": "09:07",
"kind": "custom",
"start_date": "2022-09-29",
"end_date": "2022-10-01",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": [
{
"id": "9",
"type": "virtual_keys"
},
{
"id": "10",
"type": "virtual_keys"
}
]
},
"devices": {
"data": []
}
}
},
"included": [
{
"id": "9",
"type": "virtual_keys",
"attributes": {
"name": "Custom Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-4yeq14.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "450768",
"instructions_url": "http://user.butterflymx.test/public/franecki-and-sons-135/virtual_keys/9/12189534ab583c536c9319c595e5e998",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
},
{
"id": "10",
"type": "virtual_keys",
"attributes": {
"name": "Custom Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-1dbtv7b.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "089662",
"instructions_url": "http://user.butterflymx.test/public/franecki-and-sons-135/virtual_keys/10/9ed10c70c0bfedc098210347b0caacea",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
}
]
}POST /v3/keychains/custom
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"name": "Custom Key",
"starts_at": "2022-09-29T09:07:20+00:00",
"ends_at": "2022-10-01T09:07:15+00:00",
"recipients": [
"test@example.com",
"+12345678901"
],
"key_locker": {
"id": 3,
"compartment": "any_when_used"
}
},
"type": "keychains",
"relationships": {
"unit": {
"data": {
"type": "unit",
"id": 163
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "17",
"type": "keychains",
"attributes": {
"name": "Custom Key",
"weekdays": [],
"starts_at": "2022-09-29T09:07:20Z",
"ends_at": "2022-10-01T09:07:15Z",
"time_from": "09:07",
"time_to": "09:07",
"kind": "custom",
"start_date": "2022-09-29",
"end_date": "2022-10-01",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": [
{
"id": "11",
"type": "virtual_keys"
},
{
"id": "12",
"type": "virtual_keys"
}
]
},
"devices": {
"data": []
}
}
},
"included": [
{
"id": "11",
"type": "virtual_keys",
"attributes": {
"name": "Custom Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-1oq1l66.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "376748",
"instructions_url": "http://user.butterflymx.test/public/dickens-rosenbaum-176/virtual_keys/11/f4a83f2bcac6616ebfdc52d0af62f6a3",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
},
{
"id": "12",
"type": "virtual_keys",
"attributes": {
"name": "Custom Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-1o47sal.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "986984",
"instructions_url": "http://user.butterflymx.test/public/dickens-rosenbaum-176/virtual_keys/12/b64eb65ee5966019617582d2ced26bd3",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
}
]
}POST /v3/keychains/custom
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"name": "Custom Key",
"starts_at": "2022-09-29T09:07:22+00:00",
"ends_at": "2022-10-01T09:07:17+00:00",
"recipients": [
"test@example.com",
"+12345678901"
],
"key_locker": {
"id": 4,
"compartment_id": 64
}
},
"type": "keychains",
"relationships": {
"unit": {
"data": {
"type": "unit",
"id": 185
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "18",
"type": "keychains",
"attributes": {
"name": "Custom Key",
"weekdays": [],
"starts_at": "2022-09-29T09:07:22Z",
"ends_at": "2022-10-01T09:07:17Z",
"time_from": "09:07",
"time_to": "09:07",
"kind": "custom",
"start_date": "2022-09-29",
"end_date": "2022-10-01",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": [
{
"id": "13",
"type": "virtual_keys"
},
{
"id": "14",
"type": "virtual_keys"
}
]
},
"devices": {
"data": []
}
}
},
"included": [
{
"id": "13",
"type": "virtual_keys",
"attributes": {
"name": "Custom Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-1ggs3o4.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "125849",
"instructions_url": "http://user.butterflymx.test/public/homenick-osinski-and-kemmer-217/virtual_keys/13/6743de5130f631e2e9f4c038af840534",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
},
{
"id": "14",
"type": "virtual_keys",
"attributes": {
"name": "Custom Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-or0wfo.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "455763",
"instructions_url": "http://user.butterflymx.test/public/homenick-osinski-and-kemmer-217/virtual_keys/14/e8aec6b06be406872dace448f7534037",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
}
]
}POST /v3/keychains/custom
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"name": "Custom Key",
"starts_at": "2022-09-29T09:07:25+00:00",
"ends_at": "2022-10-01T09:07:20+00:00",
"recipients": [
"test@example.com",
"+12345678901"
],
"key_locker": {
"id": 5,
"compartment_id": 95,
"item_return_policy": "return"
}
},
"type": "keychains",
"relationships": {
"unit": {
"data": {
"type": "unit",
"id": 207
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "19",
"type": "keychains",
"attributes": {
"name": "Custom Key",
"weekdays": [],
"starts_at": "2022-09-29T09:07:25Z",
"ends_at": "2022-10-01T09:07:20Z",
"time_from": "09:07",
"time_to": "09:07",
"kind": "custom",
"start_date": "2022-09-29",
"end_date": "2022-10-01",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": [
{
"id": "15",
"type": "virtual_keys"
},
{
"id": "16",
"type": "virtual_keys"
}
]
},
"devices": {
"data": []
}
}
},
"included": [
{
"id": "15",
"type": "virtual_keys",
"attributes": {
"name": "Custom Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-1cvkck0.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "287576",
"instructions_url": "http://user.butterflymx.test/public/smitham-llc-258/virtual_keys/15/758a4952602dc5ceb50d68ee627f3314",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
},
{
"id": "16",
"type": "virtual_keys",
"attributes": {
"name": "Custom Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-hlsjyn.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "776197",
"instructions_url": "http://user.butterflymx.test/public/smitham-llc-258/virtual_keys/16/884a7ec61fe928b7b9e8ecc2a9234c72",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
}
]
}POST /v3/keychains/custom
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"name": "Custom Key",
"starts_at": "2022-09-29T09:07:27+00:00",
"ends_at": "2022-10-01T09:07:22+00:00",
"recipients": [
"test@example.com",
"+12345678901"
],
"key_locker": {
"id": 6,
"compartment_id": 99
},
"item_return_policy": "return"
},
"type": "keychains",
"relationships": {
"unit": {
"data": {
"type": "unit",
"id": 229
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "20",
"type": "keychains",
"attributes": {
"name": "Custom Key",
"weekdays": [],
"starts_at": "2022-09-29T09:07:27Z",
"ends_at": "2022-10-01T09:07:22Z",
"time_from": "09:07",
"time_to": "09:07",
"kind": "custom",
"start_date": "2022-09-29",
"end_date": "2022-10-01",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": [
{
"id": "17",
"type": "virtual_keys"
},
{
"id": "18",
"type": "virtual_keys"
}
]
},
"devices": {
"data": []
}
}
},
"included": [
{
"id": "17",
"type": "virtual_keys",
"attributes": {
"name": "Custom Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-1wqoe3p.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "270409",
"instructions_url": "http://user.butterflymx.test/public/rohan-kilback-299/virtual_keys/17/ac032cdbc0c59baf0c8629a3e85d7dd6",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
},
{
"id": "18",
"type": "virtual_keys",
"attributes": {
"name": "Custom Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-1rzbr99.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "293892",
"instructions_url": "http://user.butterflymx.test/public/rohan-kilback-299/virtual_keys/18/57d5e74e3305ccc63fa1d94c8f959b7c",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
}
]
}POST /v3/keychains/custom
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"name": "Custom Key",
"starts_at": "2022-09-29T09:07:28+00:00",
"ends_at": "2022-10-01T09:07:23+00:00",
"recipients": [
"test@example.com",
"+12345678901"
]
},
"type": "keychains",
"relationships": {
"tenant": {
"data": {
"type": "tenant",
"id": 49
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "21",
"type": "keychains",
"attributes": {
"name": "Custom Key",
"weekdays": [],
"starts_at": "2022-09-29T09:07:28Z",
"ends_at": "2022-10-01T09:07:23Z",
"time_from": "09:07",
"time_to": "09:07",
"kind": "custom",
"start_date": "2022-09-29",
"end_date": "2022-10-01",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": [
{
"id": "19",
"type": "virtual_keys"
},
{
"id": "20",
"type": "virtual_keys"
}
]
},
"devices": {
"data": []
}
}
},
"included": [
{
"id": "19",
"type": "virtual_keys",
"attributes": {
"name": "Custom Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-1wfzjbo.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "812549",
"instructions_url": "http://user.butterflymx.test/public/davis-gislason-340/virtual_keys/19/fa68e38a7792c7d62511d27e09cb3597",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
},
{
"id": "20",
"type": "virtual_keys",
"attributes": {
"name": "Custom Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-1j1x643.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "725754",
"instructions_url": "http://user.butterflymx.test/public/davis-gislason-340/virtual_keys/20/a4ffa57df57c04d08f778a97610267cc",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
}
]
}POST /v3/keychains/custom
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"name": "Custom Key",
"starts_at": "",
"ends_at": "2022-10-01T09:07:23+00:00",
"recipients": [
"test@example.com",
"+12345678901"
]
},
"type": "keychains",
"relationships": {
"tenant": {
"data": {
"type": "tenant",
"id": 50
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"source": {
"pointer": "/data/attributes/starts_at"
},
"detail": "can't be blank"
},
{
"source": {
"pointer": "/data/attributes/starts_at"
},
"detail": "is not a valid datetime"
},
{
"source": {
"pointer": "/data/attributes/ends_at"
},
"detail": "Error occurred validating ends_at for :after restriction:\ncomparison of ActiveSupport::TimeWithZone with nil failed"
}
]
}Create Custom KeychainPOST/v3/keychains/custom
GET /v3/keychains
Requests
GET /v3/keychains
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": [
{
"id": "27",
"type": "keychains",
"attributes": {
"name": "Direct Construction Analyst 19",
"weekdays": [],
"starts_at": "2022-09-29T09:07:28Z",
"ends_at": "2022-09-29T10:07:28Z",
"time_from": "09:07",
"time_to": "10:07",
"kind": "custom",
"start_date": "2022-09-29",
"end_date": "2022-09-29",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": []
},
"devices": {
"data": []
}
}
},
{
"id": "26",
"type": "keychains",
"attributes": {
"name": "Forward Healthcare Specialist 18",
"weekdays": [],
"starts_at": "2022-09-29T09:07:28Z",
"ends_at": "2022-09-29T10:07:28Z",
"time_from": "09:07",
"time_to": "10:07",
"kind": "custom",
"start_date": "2022-09-29",
"end_date": "2022-09-29",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": []
},
"devices": {
"data": []
}
}
},
{
"id": "25",
"type": "keychains",
"attributes": {
"name": "Senior Technology Associate 17",
"weekdays": [],
"starts_at": "2022-09-29T09:07:28Z",
"ends_at": "2022-09-29T10:07:28Z",
"time_from": "09:07",
"time_to": "10:07",
"kind": "custom",
"start_date": "2022-09-29",
"end_date": "2022-09-29",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": [
{
"id": "23",
"type": "virtual_keys"
}
]
},
"devices": {
"data": []
}
}
}
],
"links": {
"self": "http://api.butterflymx.com/v3/keychains?page%5Bnumber%5D=1&page%5Bsize%5D=20",
"first": "http://api.butterflymx.com/v3/keychains?page%5Bnumber%5D=1&page%5Bsize%5D=20",
"prev": null,
"next": null,
"last": "http://api.butterflymx.com/v3/keychains?page%5Bnumber%5D=1&page%5Bsize%5D=20"
}
}GET /v3/keychains?include=virtual_keys,devices
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": [
{
"id": "30",
"type": "keychains",
"attributes": {
"name": "Customer Assistant 22",
"weekdays": [],
"starts_at": "2022-09-29T09:07:29Z",
"ends_at": "2022-09-29T10:07:29Z",
"time_from": "09:07",
"time_to": "10:07",
"kind": "custom",
"start_date": "2022-09-29",
"end_date": "2022-09-29",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": []
},
"devices": {
"data": []
}
}
},
{
"id": "29",
"type": "keychains",
"attributes": {
"name": "Legacy Planner 21",
"weekdays": [],
"starts_at": "2022-09-29T09:07:29Z",
"ends_at": "2022-09-29T10:07:29Z",
"time_from": "09:07",
"time_to": "10:07",
"kind": "custom",
"start_date": "2022-09-29",
"end_date": "2022-09-29",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": []
},
"devices": {
"data": []
}
}
},
{
"id": "28",
"type": "keychains",
"attributes": {
"name": "Chief Supervisor 20",
"weekdays": [],
"starts_at": "2022-09-29T09:07:29Z",
"ends_at": "2022-09-29T10:07:29Z",
"time_from": "09:07",
"time_to": "10:07",
"kind": "custom",
"start_date": "2022-09-29",
"end_date": "2022-09-29",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": [
{
"id": "24",
"type": "virtual_keys"
}
]
},
"devices": {
"data": []
}
}
}
],
"included": [
{
"id": "24",
"type": "virtual_keys",
"attributes": {
"name": "Tiesha Bashirian",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-16f44w.png",
"email": "christena@example.com",
"sms_number": "+12546272057",
"used_at": null,
"one_time_key_used_at": null,
"pin": "679983",
"instructions_url": "http://user.butterflymx.test/public/hauck-baumbach-362/virtual_keys/24/1f7136289db10a9bb5e984e884fca852",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
}
],
"links": {
"self": "http://api.butterflymx.com/v3/keychains?include=virtual_keys%2Cdevices&page%5Bnumber%5D=1&page%5Bsize%5D=20",
"first": "http://api.butterflymx.com/v3/keychains?include=virtual_keys%2Cdevices&page%5Bnumber%5D=1&page%5Bsize%5D=20",
"prev": null,
"next": null,
"last": "http://api.butterflymx.com/v3/keychains?include=virtual_keys%2Cdevices&page%5Bnumber%5D=1&page%5Bsize%5D=20"
}
}ListGET/v3/keychains
GET /v3/keychains/31
Requests
GET /v3/keychains/31
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "31",
"type": "keychains",
"attributes": {
"name": "Senior Developer 23",
"weekdays": [],
"starts_at": "2022-09-29T09:07:29Z",
"ends_at": "2022-09-29T10:07:29Z",
"time_from": "09:07",
"time_to": "10:07",
"kind": "custom",
"start_date": "2022-09-29",
"end_date": "2022-09-29",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": [
{
"id": "25",
"type": "virtual_keys"
}
]
},
"devices": {
"data": []
}
}
}
}DELETE /v3/keychains/32
Requests
DELETE /v3/keychains/32
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
This response has no content.
POST /v3/keychains/one_time
Requests
POST /v3/keychains/one_time
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"name": "One-Time Key",
"starts_at": "2022-09-29T09:07:39+00:00",
"ends_at": "2022-10-01T09:07:34+00:00",
"recipients": [
"test@example.com",
"+12345678901"
]
},
"type": "keychains",
"relationships": {
"unit": {
"data": {
"type": "unit",
"id": 308
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "33",
"type": "keychains",
"attributes": {
"name": "One-Time Key",
"weekdays": [],
"starts_at": "2022-09-29T09:07:39Z",
"ends_at": "2022-10-01T09:07:34Z",
"time_from": "09:07",
"time_to": "09:07",
"kind": "one_time",
"start_date": "2022-09-29",
"end_date": "2022-10-01",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": [
{
"id": "27",
"type": "virtual_keys"
},
{
"id": "28",
"type": "virtual_keys"
}
]
},
"devices": {
"data": []
}
}
},
"included": [
{
"id": "27",
"type": "virtual_keys",
"attributes": {
"name": "One-Time Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-1cuoqdg.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "074154",
"instructions_url": "http://user.butterflymx.test/public/cruickshank-davis-and-willms-385/virtual_keys/27/3230ce231555b3c8707219b4d4d739ba",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
},
{
"id": "28",
"type": "virtual_keys",
"attributes": {
"name": "One-Time Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-1c3qjkj.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "779068",
"instructions_url": "http://user.butterflymx.test/public/cruickshank-davis-and-willms-385/virtual_keys/28/e01706ae2c9cb8348f2fd3cbbc31f66f",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
}
]
}POST /v3/keychains/one_time
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"name": "One-Time Key",
"starts_at": "2022-09-29T09:07:39+00:00",
"ends_at": "2022-10-01T09:07:34+00:00",
"recipients": [
"test@example.com",
"+12345678901"
]
},
"type": "keychains",
"relationships": {
"tenant": {
"data": {
"type": "tenant",
"id": 2278
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "34",
"type": "keychains",
"attributes": {
"name": "One-Time Key",
"weekdays": [],
"starts_at": "2022-09-29T09:07:39Z",
"ends_at": "2022-10-01T09:07:34Z",
"time_from": "09:07",
"time_to": "09:07",
"kind": "one_time",
"start_date": "2022-09-29",
"end_date": "2022-10-01",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": [
{
"id": "29",
"type": "virtual_keys"
},
{
"id": "30",
"type": "virtual_keys"
}
]
},
"devices": {
"data": []
}
}
},
"included": [
{
"id": "29",
"type": "virtual_keys",
"attributes": {
"name": "One-Time Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-10tt0ux.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "531419",
"instructions_url": "http://user.butterflymx.test/public/leffler-ryan-386/virtual_keys/29/7de2d5ec69c5d557e711afee1304af62",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
},
{
"id": "30",
"type": "virtual_keys",
"attributes": {
"name": "One-Time Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-1ccw4gm.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "379183",
"instructions_url": "http://user.butterflymx.test/public/leffler-ryan-386/virtual_keys/30/63d3dd3018f820870ced6d35261812a5",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
}
]
}POST /v3/keychains/one_time
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"name": "One-Time Key",
"starts_at": "",
"ends_at": "2022-10-01T09:07:35+00:00",
"recipients": [
"test@example.com",
"+12345678901"
]
},
"type": "keychains",
"relationships": {
"tenant": {
"data": {
"type": "tenant",
"id": 2279
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"source": {
"pointer": "/data/attributes/starts_at"
},
"detail": "can't be blank"
},
{
"source": {
"pointer": "/data/attributes/starts_at"
},
"detail": "is not a valid datetime"
},
{
"source": {
"pointer": "/data/attributes/ends_at"
},
"detail": "Error occurred validating ends_at for :after restriction:\ncomparison of ActiveSupport::TimeWithZone with nil failed"
}
]
}Create One-Time KeychainPOST/v3/keychains/one_time
POST /v3/keychains/recurring
Requests
POST /v3/keychains/recurring
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"name": "Recurring Key",
"start_date": "2022-09-29",
"end_date": "2022-10-01",
"time_from": "11:20",
"time_to": "11:50",
"weekdays": [
"wed",
"sat"
],
"recipients": [
"test@example.com",
"+12345678901"
]
},
"type": "keychains",
"relationships": {
"unit": {
"data": {
"type": "unit",
"id": 327
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "39",
"type": "keychains",
"attributes": {
"name": "Recurring Key",
"weekdays": [
"wed",
"sat"
],
"starts_at": "2022-09-29T11:20:00Z",
"ends_at": "2022-10-01T11:50:00Z",
"time_from": "11:20",
"time_to": "11:50",
"kind": "recurring",
"start_date": "2022-09-29",
"end_date": "2022-10-01",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": [
{
"id": "33",
"type": "virtual_keys"
},
{
"id": "34",
"type": "virtual_keys"
}
]
},
"devices": {
"data": []
}
}
},
"included": [
{
"id": "33",
"type": "virtual_keys",
"attributes": {
"name": "Recurring Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-hdupbk.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "542854",
"instructions_url": "http://user.butterflymx.test/public/hayes-llc-400/virtual_keys/33/fc5752f4e9de55ed96ba3c99feea5ead",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
},
{
"id": "34",
"type": "virtual_keys",
"attributes": {
"name": "Recurring Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-1k1vsme.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "975619",
"instructions_url": "http://user.butterflymx.test/public/hayes-llc-400/virtual_keys/34/64478c35debd90ffd90b2720c5259ab9",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
}
]
}POST /v3/keychains/recurring
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"name": "Recurring Key",
"start_date": "2022-09-29",
"end_date": "2022-10-01",
"time_from": "11:20",
"time_to": "11:50",
"weekdays": [
"wed",
"sat"
],
"recipients": [
"test@example.com",
"+12345678901"
]
},
"type": "keychains",
"relationships": {
"tenant": {
"data": {
"type": "tenant",
"id": 2289
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "40",
"type": "keychains",
"attributes": {
"name": "Recurring Key",
"weekdays": [
"wed",
"sat"
],
"starts_at": "2022-09-29T11:20:00Z",
"ends_at": "2022-10-01T11:50:00Z",
"time_from": "11:20",
"time_to": "11:50",
"kind": "recurring",
"start_date": "2022-09-29",
"end_date": "2022-10-01",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": [
{
"id": "35",
"type": "virtual_keys"
},
{
"id": "36",
"type": "virtual_keys"
}
]
},
"devices": {
"data": []
}
}
},
"included": [
{
"id": "35",
"type": "virtual_keys",
"attributes": {
"name": "Recurring Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-bszw54.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "236899",
"instructions_url": "http://user.butterflymx.test/public/goodwin-inc-401/virtual_keys/35/de095a2474102147850e28734942a452",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
},
{
"id": "36",
"type": "virtual_keys",
"attributes": {
"name": "Recurring Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-1x5fqkg.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "549090",
"instructions_url": "http://user.butterflymx.test/public/goodwin-inc-401/virtual_keys/36/4bd31fc6cd69a190adf1ea5529febec8",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
}
]
}POST /v3/keychains/recurring
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "keychains",
"attributes": {
"name": "Recurring Key",
"start_date": "2022-09-29",
"end_date": "2022-10-01",
"time_from": "11:20",
"time_to": "11:50",
"weekdays": [
"wed",
"sat"
],
"recipients": [
"test@example.com",
"+12345678901"
]
},
"relationships": {
"devices": {
"data": [
{
"id": "52",
"type": "panels"
},
{
"id": "53",
"type": "panels"
}
]
},
"tenant": {
"data": {
"id": "2290",
"type": "tenant"
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "41",
"type": "keychains",
"attributes": {
"name": "Recurring Key",
"weekdays": [
"wed",
"sat"
],
"starts_at": "2022-09-29T11:20:00Z",
"ends_at": "2022-10-01T11:50:00Z",
"time_from": "11:20",
"time_to": "11:50",
"kind": "recurring",
"start_date": "2022-09-29",
"end_date": "2022-10-01",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": [
{
"id": "37",
"type": "virtual_keys"
},
{
"id": "38",
"type": "virtual_keys"
}
]
},
"devices": {
"data": [
{
"id": "52",
"type": "panels"
},
{
"id": "53",
"type": "panels"
}
]
}
}
},
"included": [
{
"id": "37",
"type": "virtual_keys",
"attributes": {
"name": "Recurring Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-1t6tpe7.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "857192",
"instructions_url": "http://user.butterflymx.test/public/miller-padberg-and-price-402/virtual_keys/37/188edf6056557b341fdea81aebb4c2af",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
},
{
"id": "38",
"type": "virtual_keys",
"attributes": {
"name": "Recurring Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-165pc58.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "741625",
"instructions_url": "http://user.butterflymx.test/public/miller-padberg-and-price-402/virtual_keys/38/4d00ae78d7ade6f26542717235ac0884",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
},
{
"id": "52",
"type": "panels",
"attributes": {
"name": "Gaius Helen Mohiam 177",
"nfc": {
"uuid": "5bab4225-6a80-4615-94b3-8b56945353f9"
}
},
"relationships": {
"building": {
"data": {
"id": "1379",
"type": "buildings"
}
}
}
},
{
"id": "53",
"type": "panels",
"attributes": {
"name": "Hasimir Fenring 178",
"nfc": {
"uuid": "a03da298-cb00-4331-958b-ca4d463f59a3"
}
},
"relationships": {
"building": {
"data": {
"id": "1379",
"type": "buildings"
}
}
}
}
]
}POST /v3/keychains/recurring
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"name": "",
"start_date": "2022-09-29",
"end_date": "2022-10-01",
"time_from": "11:20",
"time_to": "11:50",
"weekdays": [
"wed",
"sat"
],
"recipients": [
"test@example.com",
"+12345678901"
]
},
"type": "keychains",
"relationships": {
"tenant": {
"data": {
"type": "tenant",
"id": 2291
}
}
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"source": {
"pointer": "/data/attributes/name"
},
"detail": "can't be blank"
}
]
}Create Recurring KeychainPOST/v3/keychains/recurring
Virtual Keys ¶
POST /v3/keychains/35/virtual_keys
Requests
POST /v3/keychains/35/virtual_keys
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"name": "Virtual Key",
"email": "test@example.com"
},
"type": "virtual_keys",
"relationships": null
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "31",
"type": "virtual_keys",
"attributes": {
"name": "Virtual Key",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/original/qr_code_20220929-921-yo54f5.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "954339",
"instructions_url": "http://user.butterflymx.test/public/o-kon-hammes-and-morissette-396/virtual_keys/31/aab8c17b0c9859b7382b45ca7a547f92",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
}
}POST /v3/keychains/36/virtual_keys
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"name": "Virtual Key",
"sms_number": "DOES_NOT_EXIST"
},
"type": "virtual_keys",
"relationships": null
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"source": {
"pointer": "/data/attributes/sms_number"
},
"detail": "DOES_NOT_EXIST is invalid"
}
]
}POST /v3/keychains/DOES_NOT_EXIST/virtual_keys
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"name": "Virtual Key",
"email": "test@example.com"
},
"type": "virtual_keys",
"relationships": null
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"title": "Record not found",
"detail": "Requested record could not be found"
}
]
}CreatePOST/v3/keychains/{keychain_id}/virtual_keys
URI Parameters
- keychain_id
number(required) Example: 35
DELETE /v3/keychains/38/virtual_keys/32
Requests
DELETE /v3/keychains/38/virtual_keys/32
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
This response has no content.
DeleteDELETE/v3/keychains/{keychain_id}/virtual_keys/{id}
URI Parameters
- keychain_id
number(required) Example: 38- id
number(required) Example: 32
Notifications ¶
Call Accepted ¶
POST /v3/notifications/call_accepted
Requests
POST /v3/notifications/call_accepted
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "notifications",
"id": "42",
"attributes": {
"panel_id": 42,
"video": true,
"audio": false,
"call_guid": "aad288e2-1308-488d-b8d2-b95e30c01c26"
}
}
}Responses
This response has no content.
POST /v3/notifications/call_accepted
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "notifications",
"id": "43",
"attributes": {
"panel_id": "NOT_EXIST",
"video": true,
"audio": false,
"call_guid": "a79593fd-b8ba-4b3a-917a-bff6979aefd3"
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"source": {
"pointer": "/data/attributes/panel_id"
},
"detail": "No panel with that ID"
}
]
}Call AcceptedPOST/v3/notifications/call_accepted
Call Ended ¶
POST /v3/notifications/call_ended
Requests
POST /v3/notifications/call_ended
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "notifications",
"id": "44",
"attributes": {
"panel_id": 44,
"call_guid": "9f7e709f-7fb7-4e42-a802-f6906a029ee7"
}
}
}Responses
This response has no content.
POST /v3/notifications/call_ended
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "notifications",
"id": "45",
"attributes": {
"panel_id": "NOT_EXIST",
"call_guid": "07101469-6247-4b92-af9b-47d140b5966f"
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"source": {
"pointer": "/data/attributes/panel_id"
},
"detail": "No panel with that ID"
}
]
}Call EndedPOST/v3/notifications/call_ended
Is Active ¶
POST /v3/notifications/is_active
Requests
POST /v3/notifications/is_active
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "notifications",
"id": "46",
"attributes": {
"panel_id": 46,
"call_guid": "7ac657b5-4775-4b75-8f75-5b4da8aeab5e"
}
}
}Responses
This response has no content.
POST /v3/notifications/is_active
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "notifications",
"id": "47",
"attributes": {
"panel_id": "NOT_EXIST",
"call_guid": "bb63ea73-5a46-41ec-893f-cba6a6cd2d5d"
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"source": {
"pointer": "/data/attributes/panel_id"
},
"detail": "No panel with that ID"
}
]
}Is ActivePOST/v3/notifications/is_active
Open Door ¶
POST /v3/notifications/open_door
Requests
POST /v3/notifications/open_door
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "notifications",
"id": "48",
"attributes": {
"panel_id": 48,
"call_guid": "8f0ee77a-e685-44c3-afd1-bc6b3e3de87f"
}
}
}Responses
This response has no content.
POST /v3/notifications/open_door
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "notifications",
"id": "49",
"attributes": {
"panel_id": "NOT_EXIST",
"call_guid": "fdefbf3b-5355-4d8b-baae-1c0014d9d116"
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"source": {
"pointer": "/data/attributes/panel_id"
},
"detail": "No panel with that ID"
}
]
}Open DoorPOST/v3/notifications/open_door
Toggle Camera ¶
POST /v3/notifications/toggle_camera
Requests
POST /v3/notifications/toggle_camera
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "notifications",
"id": "50",
"attributes": {
"panel_id": 50,
"video": true,
"audio": false,
"call_guid": "d67b4247-aa7c-413b-b0a6-8aae6f1e592f"
}
}
}Responses
This response has no content.
POST /v3/notifications/toggle_camera
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "notifications",
"id": "51",
"attributes": {
"panel_id": "NOT_EXIST",
"video": true,
"audio": false,
"call_guid": "ecb62f29-ef93-4ade-ac53-ec4537385a46"
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"source": {
"pointer": "/data/attributes/panel_id"
},
"detail": "No panel with that ID"
}
]
}Toggle CameraPOST/v3/notifications/toggle_camera
Pins ¶
Pins ¶
On these endpoints you can create and view PINs for tenants. The id parameter in the request must be the id of the tenant.
Parameters that are required for pins:
id -> integer
code -> string (must be numeric)
POST /v3/pins/combine
Requests
POST /v3/pins/combine
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "pins",
"id": "2280",
"attributes": {}
}
}Responses
This response has no content.
CombinePOST/v3/pins/combine
GET /v3/pins/2281
Requests
GET /v3/pins/2281
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "2281",
"type": "pins",
"attributes": {
"code": "5834",
"unique_code": null
}
}
}PUT /v3/pins
Requests
PUT /v3/pins
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "pins",
"id": "2282",
"attributes": {
"code": "0854",
"unique_code": "085436"
}
}
}Responses
This response has no content.
PUT /v3/pins
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "pins",
"id": "2283",
"attributes": {
"code": ""
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"source": {
"pointer": "/data/attributes/code"
},
"detail": "can't be blank"
},
{
"source": {
"pointer": "/data/attributes/code"
},
"detail": "is not a number"
},
{
"source": {
"pointer": "/data/attributes/code"
},
"detail": "is the wrong length (should be 4 characters)"
}
]
}SetPUT/v3/pins
Tenants ¶
Integrations ¶
Integrations
Allowed integrators:
webhook
Allowed config attributes for integrators:
- webhook
- url (String)
- method (String
getorpost)
Allowed binding resource types:
-
call -
door_release
GET /v3/tenants/2262/integrations
Requests
GET /v3/tenants/2262/integrations
Headers
Accept: application/vnd.api+json
Content-Type: application/jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": [
{
"id": "bb7b0ec9-8b2f-46c4-a1c7-4bf439ca4c70",
"type": "integrations",
"attributes": {
"integrator": "webhook",
"config": {
"method": "get",
"url": "http://localhost:999"
},
"bindings": [
{
"resource_type": "door_release",
"resource_id": "7",
"actions": [
"update",
"destroy"
]
}
]
},
"relationships": {
"bindings": {
"data": [
{
"resource_type": "door_release",
"resource_id": "7",
"actions": [
"update",
"destroy"
]
}
]
},
"building": {
"data": null
},
"tenant": {
"data": {
"id": "2262",
"type": "units_users"
}
}
},
"links": {
"self": "http://api.butterflymx.com/v3/tenants/2262/integrations/bb7b0ec9-8b2f-46c4-a1c7-4bf439ca4c70"
}
}
],
"links": {
"self": "http://api.butterflymx.com/v3/tenants/2262/integrations?page%5Bnumber%5D=1&page%5Bsize%5D=10",
"first": "http://api.butterflymx.com/v3/tenants/2262/integrations?page%5Bnumber%5D=1&page%5Bsize%5D=10",
"prev": null,
"next": null,
"last": "http://api.butterflymx.com/v3/tenants/2262/integrations?page%5Bnumber%5D=1&page%5Bsize%5D=10"
}
}GET /v3/tenants/2262/integrations/bb7b0ec9-8b2f-46c4-a1c7-4bf439ca4c70
Requests
GET /v3/tenants/2262/integrations/bb7b0ec9-8b2f-46c4-a1c7-4bf439ca4c70
Headers
Accept: application/vnd.api+json
Content-Type: application/jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "bb7b0ec9-8b2f-46c4-a1c7-4bf439ca4c70",
"type": "integrations",
"attributes": {
"integrator": "webhook",
"config": {
"method": "get",
"url": "http://localhost:999"
},
"bindings": [
{
"resource_type": "door_release",
"resource_id": "7",
"actions": [
"update",
"destroy"
]
}
]
},
"relationships": {
"bindings": {
"data": [
{
"resource_type": "door_release",
"resource_id": "7",
"actions": [
"update",
"destroy"
]
}
]
},
"building": {
"data": null
},
"tenant": {
"data": {
"id": "2262",
"type": "units_users"
}
}
},
"links": {
"self": "http://api.butterflymx.com/v3/tenants/2262/integrations/bb7b0ec9-8b2f-46c4-a1c7-4bf439ca4c70"
}
}
}ShowGET/v3/tenants/{tenant_id}/integrations/{id}
URI Parameters
- tenant_id
number(required) Example: 2262- id
string(required) Example: bb7b0ec9-8b2f-46c4-a1c7-4bf439ca4c70
POST /v3/tenants/2262/integrations
Requests
POST /v3/tenants/2262/integrations
Headers
Accept: application/vnd.api+json
Content-Type: application/jsonBody
{
"data": {
"type": "integrations",
"attributes": {
"integrator": "webhook",
"configuration": {
"url": "http://localhost:666",
"method": "post"
},
"bindings": [
{
"actions": [
"create"
],
"resource_type": "call",
"resource_id": null
}
]
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "bb7b0ec9-8b2f-46c4-a1c7-4bf439ca4c70",
"type": "integrations",
"attributes": {
"integrator": "webhook",
"config": {
"method": "post",
"url": "http://localhost:666"
},
"bindings": [
{
"resource_type": "call",
"resource_id": null,
"actions": [
"create"
]
}
]
},
"relationships": {
"bindings": {
"data": [
{
"resource_type": "call",
"resource_id": null,
"actions": [
"create"
]
}
]
},
"building": {
"data": null
},
"tenant": {
"data": {
"id": "2262",
"type": "units_users"
}
}
},
"links": {
"self": "http://api.butterflymx.com/v3/tenants/2262/integrations/bb7b0ec9-8b2f-46c4-a1c7-4bf439ca4c70"
}
}
}CreatePOST/v3/tenants/{tenant_id}/integrations
URI Parameters
- tenant_id
number(required) Example: 2262
PATCH /v3/tenants/2262/integrations/bb7b0ec9-8b2f-46c4-a1c7-4bf439ca4c70
Requests
PATCH /v3/tenants/2262/integrations/bb7b0ec9-8b2f-46c4-a1c7-4bf439ca4c70
Headers
Accept: application/vnd.api+json
Content-Type: application/jsonBody
{
"data": {
"type": "integrations",
"attributes": {
"integrator": "webhook",
"configuration": {
"url": "http://localhost:999",
"method": "get"
},
"bindings": [
{
"actions": [
"update",
"destroy"
],
"resource_type": "door_release",
"resource_id": "7"
}
]
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "bb7b0ec9-8b2f-46c4-a1c7-4bf439ca4c70",
"type": "integrations",
"attributes": {
"integrator": "webhook",
"config": {
"method": "get",
"url": "http://localhost:999"
},
"bindings": [
{
"resource_type": "door_release",
"resource_id": "7",
"actions": [
"update",
"destroy"
]
}
]
},
"relationships": {
"bindings": {
"data": [
{
"resource_type": "door_release",
"resource_id": "7",
"actions": [
"update",
"destroy"
]
}
]
},
"building": {
"data": null
},
"tenant": {
"data": {
"id": "2262",
"type": "units_users"
}
}
},
"links": {
"self": "http://api.butterflymx.com/v3/tenants/2262/integrations/bb7b0ec9-8b2f-46c4-a1c7-4bf439ca4c70"
}
}
}UpdatePATCH/v3/tenants/{tenant_id}/integrations/{id}
URI Parameters
- tenant_id
number(required) Example: 2262- id
string(required) Example: bb7b0ec9-8b2f-46c4-a1c7-4bf439ca4c70
DELETE /v3/tenants/2262/integrations/bb7b0ec9-8b2f-46c4-a1c7-4bf439ca4c70
Requests
DELETE /v3/tenants/2262/integrations/bb7b0ec9-8b2f-46c4-a1c7-4bf439ca4c70
Headers
Accept: application/vnd.api+json
Content-Type: application/jsonResponses
This response has no content.
DeleteDELETE/v3/tenants/{tenant_id}/integrations/{id}
URI Parameters
- tenant_id
number(required) Example: 2262- id
string(required) Example: bb7b0ec9-8b2f-46c4-a1c7-4bf439ca4c70
Tenants ¶
Assign User to the Unit as a Tenant
A user is assigned as a unit’s tenant by creating a tenancy. This can be achieved with API call: POST /v3/tenants
And sending following required attributes:
-
email(String) - must be a valid email address -
first_name(String) -
last_name(String) -
unit_id(Integer)
Optional Attributes:
-
active_at(DateTime) - inISO 8601format e.g.2017-12-27T11:03:50Z -
inactive_at(DateTime) -
pin(String) -
directory_message(String) -
display_name_strategy(String), one of the allowed values:buildingcustomfirst_name_and_last_namefirst_name_initial_and_last_nameanonymousfirst_name_and_last_name_initial
-
sms_notifications(Boolean) -
email_notifications(Boolean) -
preferences(Object)calls(Object)push(Boolean)email(Boolean)sms(Boolean)
door_opens(Object)push(Boolean)email(Boolean)sms(Boolean)
messages(Object)push(Boolean)email(Boolean)sms(Boolean)
-
do_not_disturb(Boolean) -
skip_registration_email(Boolean)
When a valid email is submitted, then:
-
if there is no registered user in ButterflyMX with this email, a new user will be created and added as a tenant. Additionally, a registration e-mail will be sent to the users e-mail address unless skip_registration_email parameter is set to true
-
if there is a registered user with this email, an existing user will be added as a tenant (submitted attributes
first_nameandlast_namewill be ignored)
On success, server will respond with a 201 Created status code and a JSON API document.
Sortable fields:
created_at
Filterable fields:
-
display_name_strategy -
display_only_on_search -
pin_enabled -
email_notifications -
sms_notifications -
do_not_disturb
Enumerations:
display_name_strategy:buildingcustomfirst_name_and_last_namefirst_name_initial_and_last_nameanonymousfirst_name_and_last_name_initial
GET /v3/tenants
Requests
GET /v3/tenants
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": [
{
"id": "2295",
"type": "tenants",
"attributes": {
"active_at": "2022-09-29T09:07:42Z",
"inactive_at": null,
"qr_key_enabled": true,
"delivery_pass_instructions": null,
"directory_message": "Real-Estate Liaison",
"display_name": "Maisha Predovic",
"display_name_strategy": "building",
"display_first_name": "Glenn Boyle V",
"display_last_name": "Devin Howe",
"display_only_on_search": false,
"pin_enabled": false,
"email_notifications": true,
"sms_notifications": true,
"do_not_disturb": false,
"preferences": {
"door_opens": {
"push": false,
"email": false,
"sms": null
},
"messages": {
"push": true,
"email": false,
"sms": false
}
}
},
"relationships": {
"unit": {
"data": {
"id": "337",
"type": "units"
}
},
"user": {
"data": {
"id": "107",
"type": "users"
}
}
}
},
{
"id": "2294",
"type": "tenants",
"attributes": {
"active_at": "2022-09-29T09:07:42Z",
"inactive_at": null,
"qr_key_enabled": true,
"delivery_pass_instructions": null,
"directory_message": "Regional Strategist",
"display_name": "Mr. Pablo Reilly",
"display_name_strategy": "building",
"display_first_name": "Maybelle Kautzer",
"display_last_name": "Monique Kutch",
"display_only_on_search": true,
"pin_enabled": false,
"email_notifications": true,
"sms_notifications": true,
"do_not_disturb": false,
"preferences": {
"door_opens": {
"push": false,
"email": false,
"sms": null
},
"messages": {
"push": true,
"email": false,
"sms": false
}
}
},
"relationships": {
"unit": {
"data": {
"id": "337",
"type": "units"
}
},
"user": {
"data": {
"id": "106",
"type": "users"
}
}
}
},
{
"id": "2293",
"type": "tenants",
"attributes": {
"active_at": "2022-09-29T09:07:42Z",
"inactive_at": null,
"qr_key_enabled": true,
"delivery_pass_instructions": null,
"directory_message": "Farming Administrator",
"display_name": "Jammie Maggio DDS",
"display_name_strategy": "building",
"display_first_name": "Jesica Dickinson",
"display_last_name": "Zack Considine",
"display_only_on_search": false,
"pin_enabled": false,
"email_notifications": true,
"sms_notifications": true,
"do_not_disturb": false,
"preferences": {
"door_opens": {
"push": false,
"email": false,
"sms": null
},
"messages": {
"push": true,
"email": false,
"sms": false
}
}
},
"relationships": {
"unit": {
"data": {
"id": "337",
"type": "units"
}
},
"user": {
"data": {
"id": "105",
"type": "users"
}
}
}
}
],
"included": [
{
"id": "107",
"type": "users",
"attributes": {
"name": "Bryan Cronin",
"first_name": "Bryan",
"last_name": "Cronin",
"contact_preference": "phone_call",
"thumb_url": null,
"medium_url": null,
"sip_username": "107",
"registration_status": "registered",
"email": "carmina.ferry@jenkins.biz",
"sms_phone_number": null,
"phone_number": null
}
},
{
"id": "106",
"type": "users",
"attributes": {
"name": "Odette Senger",
"first_name": "Odette",
"last_name": "Senger",
"contact_preference": "phone_call",
"thumb_url": null,
"medium_url": null,
"sip_username": "106",
"registration_status": "registered",
"email": "darron@padberg.biz",
"sms_phone_number": null,
"phone_number": null
}
},
{
"id": "105",
"type": "users",
"attributes": {
"name": "Lon McDermott",
"first_name": "Lon",
"last_name": "McDermott",
"contact_preference": "phone_call",
"thumb_url": null,
"medium_url": null,
"sip_username": "105",
"registration_status": "registered",
"email": "jerri@bechtelarlind.name",
"sms_phone_number": null,
"phone_number": null
}
}
],
"links": {
"self": "http://api.butterflymx.com/v3/tenants?page%5Bnumber%5D=1&page%5Bsize%5D=20",
"first": "http://api.butterflymx.com/v3/tenants?page%5Bnumber%5D=1&page%5Bsize%5D=20",
"prev": null,
"next": null,
"last": "http://api.butterflymx.com/v3/tenants?page%5Bnumber%5D=1&page%5Bsize%5D=20"
}
}ListGET/v3/tenants
GET /v3/tenants/2296
Requests
GET /v3/tenants/2296
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "2296",
"type": "tenants",
"attributes": {
"active_at": "2022-09-29T09:07:42Z",
"inactive_at": null,
"qr_key_enabled": true,
"delivery_pass_instructions": null,
"directory_message": "Marketing Consultant",
"display_name": "Marcos Lehner Jr.",
"display_name_strategy": "building",
"display_first_name": "Phoebe Boehm III",
"display_last_name": "Rolland Hand",
"display_only_on_search": true,
"pin_enabled": false,
"email_notifications": true,
"sms_notifications": true,
"do_not_disturb": false,
"preferences": {
"door_opens": {
"push": false,
"email": false,
"sms": null
},
"messages": {
"push": true,
"email": false,
"sms": false
}
}
},
"relationships": {
"unit": {
"data": {
"id": "339",
"type": "units"
}
},
"user": {
"data": {
"id": "109",
"type": "users"
}
}
}
},
"included": [
{
"id": "109",
"type": "users",
"attributes": {
"name": "Roberto Goldner",
"first_name": "Roberto",
"last_name": "Goldner",
"contact_preference": "phone_call",
"thumb_url": null,
"medium_url": null,
"sip_username": "109",
"registration_status": "registered",
"email": "xiomara@beatty.org",
"sms_phone_number": null,
"phone_number": null
}
}
]
}POST /v3/tenants
Requests
POST /v3/tenants
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"unit_id": 341,
"email": "delmy.brekke@caspercollier.org",
"active_at": "2022-09-29T09:07:42Z"
},
"type": "tenants",
"relationships": null
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "2297",
"type": "tenants",
"attributes": {
"active_at": "2022-09-29T09:07:42Z",
"inactive_at": null,
"qr_key_enabled": true,
"delivery_pass_instructions": null,
"directory_message": null,
"display_name": "Stroman, Nick",
"display_name_strategy": "building",
"display_first_name": "Stroman,",
"display_last_name": "Nick",
"display_only_on_search": false,
"pin_enabled": false,
"email_notifications": false,
"sms_notifications": false,
"do_not_disturb": false,
"preferences": {
"door_opens": {
"push": false,
"email": false,
"sms": null
},
"messages": {
"push": true,
"email": false,
"sms": false
}
}
},
"relationships": {
"unit": {
"data": {
"id": "341",
"type": "units"
}
},
"user": {
"data": {
"id": "111",
"type": "users"
}
}
}
}
}POST /v3/tenants
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"unit_id": 343,
"email": "",
"first_name": "",
"last_name": "User",
"active_at": "2022-09-29T09:07:42Z"
},
"type": "tenants",
"relationships": null
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"source": {
"pointer": "/data/attributes/user"
},
"detail": "must exist"
},
{
"source": {
"pointer": "/data/attributes/user"
},
"detail": "can't be blank"
}
]
}CreatePOST/v3/tenants
PATCH /v3/tenants/2298
Requests
PATCH /v3/tenants/2298
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "tenants",
"id": "2298",
"attributes": {
"do_not_disturb": true
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "2298",
"type": "tenants",
"attributes": {
"active_at": "2022-09-29T09:07:43Z",
"inactive_at": null,
"qr_key_enabled": true,
"delivery_pass_instructions": null,
"directory_message": "National Consulting Facilitator",
"display_name": "Randall Barrows",
"display_name_strategy": "building",
"display_first_name": "Modesta Grimes",
"display_last_name": "Earl Mraz",
"display_only_on_search": true,
"pin_enabled": false,
"email_notifications": true,
"sms_notifications": true,
"do_not_disturb": true,
"preferences": {
"door_opens": {
"push": false,
"email": false,
"sms": null
},
"messages": {
"push": true,
"email": false,
"sms": false
}
}
},
"relationships": {
"unit": {
"data": {
"id": "345",
"type": "units"
}
},
"user": {
"data": {
"id": "115",
"type": "users"
}
}
}
}
}PATCH /v3/tenants/2299
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "tenants",
"id": "2299",
"attributes": {
"display_name_strategy": ""
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"source": {
"pointer": "/data/attributes/user_panel_config.display_name_strategy"
},
"detail": "can't be blank"
}
]
}DELETE /v3/tenants/2300
Requests
DELETE /v3/tenants/2300
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
This response has no content.
Tours ¶
Tour Schedules ¶
Creating Tours consumes time slots. The number of time slots and the duration of a time slot is configurable in the PAC UI.
The consumed time slots can be reviewed with GET/v3/tours/{building_handle}/tour_schedules endpoint.
Times can be specified with AM/PM format timezone offsets, for example like this:
2021-04-16T02:00:00 PM -05:00 along with UTC time format described in the examples below.
GET /v3/tours/emard-predovic-415/tour_schedules
Requests
GET /v3/tours/emard-predovic-415/tour_schedules
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "1392",
"type": "buildings",
"attributes": {
"handle": "emard-predovic-415",
"name": "Emard-Predovic-415",
"slots": {
"weekday_availabilities": {
"mon": [
[
"09:00",
"22:00"
]
],
"wed": [
[
"09:00",
"22:00"
]
],
"fri": [
[
"09:00",
"22:00"
]
]
},
"scheduled_slots": {
"2020-12-14T13:00:00Z": 1,
"2020-12-14T14:00:00Z": 1,
"2020-12-14T19:00:00Z": 1
},
"reserved_slots": {
"2020-12-14T12:00:00Z": 1
},
"blacked_out_slots": [
{
"starts_at": "2020-12-14T17:00:00Z",
"ends_at": "2020-12-14T18:00:00Z"
}
]
},
"slot_duration_minutes": 60,
"max_simultaneous_bookings": 1,
"time_window_days": 14,
"address": {
"country": "us",
"address_1": "9023 Pacocha Squares",
"address_2": "Pacochamouth, ME 98922-9638",
"city": "Pacochamouth",
"state": "Maine",
"zip_code": "98922-9638",
"phone_number": "104.992.3270 x1731"
},
"enabled": true,
"tour_units": [],
"unit_selection": false,
"identity_verification": false,
"key_locker_in_use": false,
"shared_key_compartment_count": 0,
"time_zone": "Etc/UTC",
"time_zone_offset": "+00:00",
"day_of_tour_text": null,
"tos_text": null,
"day_of_tour_text_draft": null,
"credit_card_hold": false,
"email_communication": true,
"sms_communication": true,
"enable_scheduling_portal": true
}
}
}ListGET/v3/tours/{building_handle}/tour_schedules
URI Parameters
- building_handle
string(required) Example: emard-predovic-415
POST /v3/tours/trantow-heller-417/tour_schedules
Requests
POST /v3/tours/trantow-heller-417/tour_schedules
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"name": "Trantow-Heller-417 Tour",
"email": "tour@example.com",
"phone_number": "(555) 555-1234",
"starts_at": "2020-12-14T12:00:00Z"
},
"type": "tour_schedules",
"relationships": null
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "10",
"type": "tour_schedules",
"attributes": {
"name": "Trantow-Heller-417 Tour",
"email": "tour@example.com",
"starts_at": "2020-12-14T12:00:00Z",
"ends_at": "2020-12-14T13:00:00Z",
"uuid": "e46f1e7a-b385-48f8-b087-95a2862848dc",
"status": "confirmed",
"qr_key_public_url": "http://user.butterflymx.test/public/trantow-heller-417/virtual_keys/39/f44beb5cfdbbb06123dfeb93a9ce5dc7",
"pin": "186042",
"qr_key_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/medium/qr_code_20201214-921-1p0dsk7.png",
"phone_number": "(555) 555-1234",
"building_handle": "trantow-heller-417",
"building_name": "Trantow-Heller-417",
"building_address": {
"country": "us",
"address_1": "1698 Harris Circle",
"address_2": "New Doraland, HI 78091",
"city": "New Doraland",
"state": "Hawaii",
"zip_code": "78091",
"phone_number": "244.470.2266 x100"
},
"tour_units": [],
"day_of_tour_url": "http://selftours.butterflymx.test/tour/e46f1e7a-b385-48f8-b087-95a2862848dc",
"keychains": [],
"key_locker_in_use": false
}
}
}POST /v3/tours/will-cremin-419/tour_schedules
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"name": "Will-Cremin-419 Tour ",
"email": "tour@example.com",
"starts_at": "2020-12-15T11:00:00Z"
},
"type": "tour_schedules",
"relationships": null
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"source": {
"pointer": "/data/attributes/starts_at"
},
"detail": "is not available, outside availability hours"
}
]
}CreatePOST/v3/tours/{building_handle}/tour_schedules
URI Parameters
- building_handle
string(required) Example: trantow-heller-417
GET /v3/tours/201d8798-28b8-4d5e-ac8c-a98f9c90ab71
Requests
GET /v3/tours/201d8798-28b8-4d5e-ac8c-a98f9c90ab71
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "11",
"type": "tour_schedules",
"attributes": {
"name": "Confirmed Tour",
"email": "guest@example.com",
"starts_at": "2020-12-14T12:00:00Z",
"ends_at": "2020-12-14T13:00:00Z",
"uuid": "201d8798-28b8-4d5e-ac8c-a98f9c90ab71",
"status": "confirmed",
"qr_key_public_url": null,
"pin": null,
"qr_key_image_url": null,
"phone_number": "1-599-283-7311 x5965",
"building_handle": "predovic-bode-421",
"building_name": "Predovic-Bode-421",
"building_address": {
"country": "us",
"address_1": "67277 Huel Center",
"address_2": "West Trent, IA 38220-8743",
"city": "West Trent",
"state": "Iowa",
"zip_code": "38220-8743",
"phone_number": "1-792-555-2478 x64992"
},
"tour_units": [],
"day_of_tour_url": "http://selftours.butterflymx.test/tour/201d8798-28b8-4d5e-ac8c-a98f9c90ab71",
"keychains": [],
"key_locker_in_use": false
}
}
}ShowGET/v3/tours/{uuid}
URI Parameters
- uuid
string(required) Example: 201d8798-28b8-4d5e-ac8c-a98f9c90ab71
PATCH /v3/tours/ba8d12ae-c895-47f6-94aa-112c9670b571
Requests
PATCH /v3/tours/ba8d12ae-c895-47f6-94aa-112c9670b571
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "tour_schedules",
"id": "12",
"attributes": {
"starts_at": "2020-12-16T12:00:00Z"
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "12",
"type": "tour_schedules",
"attributes": {
"name": "Confirmed Tour",
"email": "guest@example.com",
"starts_at": "2020-12-16T12:00:00Z",
"ends_at": "2020-12-16T13:00:00Z",
"uuid": "ba8d12ae-c895-47f6-94aa-112c9670b571",
"status": "rescheduled",
"qr_key_public_url": "http://user.butterflymx.test/public/daniel-champlin-423/virtual_keys/40/ae7fe82317d9dc00f04d79551214daf3",
"pin": "951590",
"qr_key_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1664442235-6975f7181ef532f2925ffe2ca396e2e7/store/medium/qr_code_20201214-921-jijiuy.png",
"phone_number": "876.242.0889 x9580",
"building_handle": "daniel-champlin-423",
"building_name": "Daniel-Champlin-423",
"building_address": {
"country": "us",
"address_1": "30438 Lucrecia Underpass",
"address_2": "Hyattside, MT 63972-2425",
"city": "Hyattside",
"state": "Montana",
"zip_code": "63972-2425",
"phone_number": "(391) 025-8750 x149"
},
"tour_units": [],
"day_of_tour_url": "http://selftours.butterflymx.test/tour/ba8d12ae-c895-47f6-94aa-112c9670b571",
"keychains": [],
"key_locker_in_use": false
}
}
}UpdatePATCH/v3/tours/{uuid}
URI Parameters
- uuid
string(required) Example: ba8d12ae-c895-47f6-94aa-112c9670b571
DELETE /v3/tours/754fc48b-2363-4616-940f-edb44f7f4e39
Requests
DELETE /v3/tours/754fc48b-2363-4616-940f-edb44f7f4e39
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "13",
"type": "tour_schedules",
"attributes": {
"name": "Confirmed Tour",
"email": "guest@example.com",
"starts_at": "2020-12-14T12:00:00Z",
"ends_at": "2020-12-14T13:00:00Z",
"uuid": "754fc48b-2363-4616-940f-edb44f7f4e39",
"status": "cancelled",
"qr_key_public_url": null,
"pin": null,
"qr_key_image_url": null,
"phone_number": "(114) 720-2306",
"building_handle": "weber-halvorson-and-moore-425",
"building_name": "Weber, Halvorson and Moore-425",
"building_address": {
"country": "us",
"address_1": "1318 Deja Land",
"address_2": "Arlettehaven, NY 18349",
"city": "Arlettehaven",
"state": "New York",
"zip_code": "18349",
"phone_number": "(176) 579-9745"
},
"tour_units": [],
"day_of_tour_url": "http://selftours.butterflymx.test/tour/754fc48b-2363-4616-940f-edb44f7f4e39",
"keychains": [],
"key_locker_in_use": false
}
}
}DeleteDELETE/v3/tours/{uuid}
URI Parameters
- uuid
string(required) Example: 754fc48b-2363-4616-940f-edb44f7f4e39
Units ¶
Units ¶
Unit creation
- When creating a unit, a
building_idneeds to be sent alongside the units attributes, so a unit can be assigned to a building.
Includeable resources:
-
building -
users
Filterable fields:
-
floor_number(integer) -
kind(enumeration) -
label(string)
Sortable fields:
-
id -
floor_number -
kind -
label -
updated_at -
created_at
Enumerations:
kind:residentialcommercial
GET /v3/units/370
Requests
GET /v3/units/370
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "370",
"type": "units",
"attributes": {
"kind": "residential",
"label": "56056",
"floor_number": 56
},
"relationships": {
"building": {
"data": {
"id": "1404",
"type": "buildings"
}
},
"users": {
"data": []
}
}
}
}GET /v3/units
Requests
GET /v3/units
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": [
{
"id": "374",
"type": "units",
"attributes": {
"kind": "residential",
"label": "59059",
"floor_number": 59
},
"relationships": {
"building": {
"data": {
"id": "1406",
"type": "buildings"
}
},
"users": {
"data": []
}
}
},
{
"id": "373",
"type": "units",
"attributes": {
"kind": "residential",
"label": "58058",
"floor_number": 58
},
"relationships": {
"building": {
"data": {
"id": "1406",
"type": "buildings"
}
},
"users": {
"data": []
}
}
},
{
"id": "372",
"type": "units",
"attributes": {
"kind": "residential",
"label": "57057",
"floor_number": 57
},
"relationships": {
"building": {
"data": {
"id": "1406",
"type": "buildings"
}
},
"users": {
"data": []
}
}
},
{
"id": "371",
"type": "units",
"attributes": {
"kind": "residential",
"label": "00",
"floor_number": 0
},
"relationships": {
"building": {
"data": {
"id": "1406",
"type": "buildings"
}
},
"users": {
"data": []
}
}
}
],
"links": {
"self": "http://api.butterflymx.com/v3/units?page%5Bnumber%5D=1&page%5Bsize%5D=20",
"first": "http://api.butterflymx.com/v3/units?page%5Bnumber%5D=1&page%5Bsize%5D=20",
"prev": null,
"next": null,
"last": "http://api.butterflymx.com/v3/units?page%5Bnumber%5D=1&page%5Bsize%5D=20"
}
}GET /v3/units?include=users,building
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": [
{
"id": "378",
"type": "units",
"attributes": {
"kind": "residential",
"label": "62062",
"floor_number": 62
},
"relationships": {
"building": {
"data": {
"id": "1407",
"type": "buildings"
}
},
"users": {
"data": []
}
}
},
{
"id": "377",
"type": "units",
"attributes": {
"kind": "residential",
"label": "61061",
"floor_number": 61
},
"relationships": {
"building": {
"data": {
"id": "1407",
"type": "buildings"
}
},
"users": {
"data": []
}
}
},
{
"id": "376",
"type": "units",
"attributes": {
"kind": "residential",
"label": "60060",
"floor_number": 60
},
"relationships": {
"building": {
"data": {
"id": "1407",
"type": "buildings"
}
},
"users": {
"data": []
}
}
},
{
"id": "375",
"type": "units",
"attributes": {
"kind": "residential",
"label": "00",
"floor_number": 0
},
"relationships": {
"building": {
"data": {
"id": "1407",
"type": "buildings"
}
},
"users": {
"data": []
}
}
}
],
"included": [
{
"id": "1407",
"type": "buildings",
"attributes": {
"name": "Kuhlman Inc-430",
"building_type": "multi_family",
"display_name_strategy": "last_name_and_first_name_initial",
"qr_key_enabled": true,
"nfc_enabled": false,
"send_panel_status_report": false,
"mobile_logo_picture": {
"thumb_url": "/assets/BMX_logo-950095e4e7500998fa6993f28f8950cba6f2322a76806abb7820fa39eb6394b6.png",
"medium_url": "/assets/BMX_logo-950095e4e7500998fa6993f28f8950cba6f2322a76806abb7820fa39eb6394b6.png"
},
"panel_logo_picture": {
"thumb_url": "/assets/BMX_logo-950095e4e7500998fa6993f28f8950cba6f2322a76806abb7820fa39eb6394b6.png",
"medium_url": "/assets/BMX_logo-950095e4e7500998fa6993f28f8950cba6f2322a76806abb7820fa39eb6394b6.png"
},
"address_1": "7901 Cronin Freeway",
"address_2": "North Marianna, DE 91844",
"city": "North Marianna",
"state": "Delaware",
"zip_code": "91844",
"phone_number": "1-379-474-3238 x5838",
"country": "us",
"time_zone": "Etc/UTC",
"time_zone_offset": "+00:00",
"delivery_pass_enabled": true,
"door_release_pin": true,
"open_door_button_enabled": true
}
}
],
"links": {
"self": "http://api.butterflymx.com/v3/units?include=users%2Cbuilding&page%5Bnumber%5D=1&page%5Bsize%5D=20",
"first": "http://api.butterflymx.com/v3/units?include=users%2Cbuilding&page%5Bnumber%5D=1&page%5Bsize%5D=20",
"prev": null,
"next": null,
"last": "http://api.butterflymx.com/v3/units?include=users%2Cbuilding&page%5Bnumber%5D=1&page%5Bsize%5D=20"
}
}ListGET/v3/units
POST /v3/buildings/1408/units
Requests
POST /v3/buildings/1408/units
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"kind": "residential",
"label": "foo",
"floor_number": 11
},
"type": "units",
"relationships": null
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "380",
"type": "units",
"attributes": {
"kind": "residential",
"label": "foo",
"floor_number": 11
},
"relationships": {
"building": {
"data": {
"id": "1408",
"type": "buildings"
}
},
"users": {
"data": []
}
}
}
}POST /v3/buildings/1409/units
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "units",
"attributes": {
"kind": "residential"
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"source": {
"pointer": "/data/attributes/label"
},
"detail": "can't be blank"
},
{
"source": {
"pointer": "/data/attributes/floor_number"
},
"detail": "can't be blank"
},
{
"source": {
"pointer": "/data/attributes/floor_number"
},
"detail": "is not a number"
}
]
}POST /v3/buildings/DOES_NOT_EXIST/units
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "units",
"attributes": {
"kind": "residential",
"label": "foo",
"floor_number": 11
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"title": "Record not found",
"detail": "Requested record could not be found"
}
]
}PUT /v3/units/385
Requests
PUT /v3/units/385
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "units",
"attributes": {
"kind": "residential",
"label": "New Label",
"floor_number": 11,
"building_id": 1411
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "385",
"type": "units",
"attributes": {
"kind": "residential",
"label": "New Label",
"floor_number": 11
},
"relationships": {
"building": {
"data": {
"id": "1411",
"type": "buildings"
}
},
"users": {
"data": []
}
}
}
}PUT /v3/units/388
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "units",
"attributes": {
"label": ""
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"source": {
"pointer": "/data/attributes/label"
},
"detail": "can't be blank"
}
]
}DELETE /v3/units/391
Requests
DELETE /v3/units/391
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonResponses
This response has no content.
Generated by aglio on 29 Sep 2022