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": "Donnelly, Ortiz and O'Connell-13",
"building_type": "multi_family",
"display_name_strategy": "last_name_and_first_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-1668591622-c0cf94478c01d0247616b02b19635b86/store/thumb_small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/medium_small_picture.jpg"
},
"panel_logo_picture": {
"thumb_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/thumb_small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/medium_small_picture.jpg"
},
"address_1": "24035 Dario Extensions",
"address_2": "New Goldie, WV 17123-1394",
"city": "New Goldie",
"state": "West Virginia",
"zip_code": "17123-1394",
"phone_number": "162.354.6488 x06554",
"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": "Glossu \"Beast\" Rabban 4",
"nfc": {
"uuid": "82662ac6-1226-42e6-8025-acd8ab9a51e7"
}
},
"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": "Price-Prosacco-16",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/thumb_small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/medium_small_picture.jpg"
},
"panel_logo_picture": {
"thumb_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/thumb_small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/medium_small_picture.jpg"
},
"address_1": "852 Delta Plains",
"address_2": "Abelburgh, NY 10988",
"city": "Abelburgh",
"state": "New York",
"zip_code": "10988",
"phone_number": "748.994.8869 x66612",
"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": "Chani 5",
"nfc": {
"uuid": "244a115e-07bf-4a20-90e6-0bf90a4bcb02"
}
},
"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": "Willms-Collier-19",
"building_type": "multi_family",
"display_name_strategy": "anonymous",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/thumb_small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/medium_small_picture.jpg"
},
"panel_logo_picture": {
"thumb_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/thumb_small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/medium_small_picture.jpg"
},
"address_1": "164 Ortiz Centers",
"address_2": "Jimmymouth, CO 63679",
"city": "Jimmymouth",
"state": "Colorado",
"zip_code": "63679",
"phone_number": "(845) 098-8400 x13149",
"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": "Shaddam Corrino IV 6",
"nfc": {
"uuid": "5da1c517-d868-4931-b806-5782fe423ae4"
}
},
"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": "O34",
"open": false,
"full": true
}
},
{
"id": "2",
"type": "key_locker_compartments",
"attributes": {
"cell": "A38",
"open": false,
"full": true
}
},
{
"id": "3",
"type": "key_locker_compartments",
"attributes": {
"cell": "X18",
"open": false,
"full": true
}
},
{
"id": "4",
"type": "key_locker_compartments",
"attributes": {
"cell": "B12",
"open": false,
"full": true
}
},
{
"id": "5",
"type": "key_locker_compartments",
"attributes": {
"cell": "U14",
"open": false,
"full": true
}
},
{
"id": "6",
"type": "key_locker_compartments",
"attributes": {
"cell": "B14",
"open": false,
"full": true
}
},
{
"id": "7",
"type": "key_locker_compartments",
"attributes": {
"cell": "W14",
"open": false,
"full": true
}
},
{
"id": "8",
"type": "key_locker_compartments",
"attributes": {
"cell": "G39",
"open": false,
"full": true
}
},
{
"id": "9",
"type": "key_locker_compartments",
"attributes": {
"cell": "K4",
"open": false,
"full": true
}
},
{
"id": "10",
"type": "key_locker_compartments",
"attributes": {
"cell": "R23",
"open": false,
"full": true
}
},
{
"id": "11",
"type": "key_locker_compartments",
"attributes": {
"cell": "S39",
"open": false,
"full": true
}
},
{
"id": "12",
"type": "key_locker_compartments",
"attributes": {
"cell": "Q22",
"open": false,
"full": true
}
},
{
"id": "13",
"type": "key_locker_compartments",
"attributes": {
"cell": "C10",
"open": false,
"full": true
}
},
{
"id": "14",
"type": "key_locker_compartments",
"attributes": {
"cell": "J23",
"open": false,
"full": true
}
},
{
"id": "15",
"type": "key_locker_compartments",
"attributes": {
"cell": "M40",
"open": false,
"full": true
}
},
{
"id": "16",
"type": "key_locker_compartments",
"attributes": {
"cell": "Q30",
"open": false,
"full": true
}
},
{
"id": "17",
"type": "key_locker_compartments",
"attributes": {
"cell": "Q42",
"open": false,
"full": true
}
},
{
"id": "18",
"type": "key_locker_compartments",
"attributes": {
"cell": "L5",
"open": false,
"full": true
}
},
{
"id": "19",
"type": "key_locker_compartments",
"attributes": {
"cell": "U34",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/thumb_small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/medium_small_picture.jpg"
},
"panel_logo_picture": {
"thumb_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/thumb_small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/medium_small_picture.jpg"
},
"address_1": "8360 Mica Burgs",
"address_2": "West Larondaview, WY 88197-6987",
"city": "West Larondaview",
"state": "Wyoming",
"zip_code": "88197-6987",
"phone_number": "455-858-7078",
"country": "us",
"time_zone": "Eastern Time (US & Canada)",
"time_zone_offset": "-05: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": "Strosin LLC-64",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/thumb_small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/medium_small_picture.jpg"
},
"panel_logo_picture": {
"thumb_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/thumb_small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/medium_small_picture.jpg"
},
"address_1": "New Building Address",
"address_2": "New Marylinville, NY 66112",
"city": "New Marylinville",
"state": "New York",
"zip_code": "66112",
"phone_number": "1-510-232-4147",
"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": "Walker, Renner and Hyatt-70",
"building_type": "multi_family",
"display_name_strategy": "last_name_and_first_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-1668591622-c0cf94478c01d0247616b02b19635b86/store/thumb_small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/medium_small_picture.jpg"
},
"panel_logo_picture": {
"thumb_url": "/assets/BMX_logo-950095e4e7500998fa6993f28f8950cba6f2322a76806abb7820fa39eb6394b6.png",
"medium_url": "/assets/BMX_logo-950095e4e7500998fa6993f28f8950cba6f2322a76806abb7820fa39eb6394b6.png"
},
"address_1": "31451 Walter Stravenue",
"address_2": "Ericburgh, PA 61947-6531",
"city": "Ericburgh",
"state": "Pennsylvania",
"zip_code": "61947-6531",
"phone_number": "1-313-468-2924 x802",
"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/ef96d1de-b382-491c-9d3c-a7b70b7cf61f/status
Requests
GET /v3/me/calls/ef96d1de-b382-491c-9d3c-a7b70b7cf61f/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-11-16T09:44:02Z"
},
"relationships": {
"call": {
"data": {
"id": "1",
"type": "calls"
}
}
}
},
"included": [
{
"id": "1",
"type": "calls",
"attributes": {
"guid": "ef96d1de-b382-491c-9d3c-a7b70b7cf61f",
"call_type": "voip",
"notification_type": "visitor",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"created_at": "2022-11-16T09:40:21Z",
"logged_at": "2022-11-16T09:40:21Z",
"status": "initializing",
"display_status": "Initializing",
"panel_id": 11,
"panel_name": "Feyd-Rautha Rabban 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: ef96d1de-b382-491c-9d3c-a7b70b7cf61f
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": "2e4c7c75-1809-4467-9993-c57061b90123",
"call_type": "voip",
"notification_type": "visitor",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"created_at": "2022-11-16T09:40:21Z",
"logged_at": "2022-11-16T09:40:21Z",
"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": "84689493-acd4-4b1b-9ef7-a160d3c83830",
"call_type": "voip",
"notification_type": "visitor",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"created_at": "2022-11-16T09:40:21Z",
"logged_at": "2022-11-16T09:40:21Z",
"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": "be4e1aca-3f98-44d7-be20-53d78a433a2e",
"call_type": "voip",
"notification_type": "visitor",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"created_at": "2022-11-16T09:40:21Z",
"logged_at": "2022-11-16T09:40:21Z",
"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": "187d5c5d-397d-4ccd-a1ea-0759e8f18c41",
"delivery_guid": "c31ec813-bc7e-4ac8-b65e-18a511f77436",
"name": "Amber Jones",
"thumb_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/thumb/small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/medium/small_picture.jpg",
"created_at": "2022-11-16T09:40:21Z",
"logged_at": "2022-11-16T09:40:21Z"
},
"relationships": {
"unit": {
"data": {
"id": "81",
"type": "units"
}
},
"user": {
"data": {
"id": "44",
"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": "be1bc1ae-a036-45ec-805b-724becc4bbcf",
"delivery_guid": "bed8d81a-fcd8-45b9-9e5c-c13e49dd781c",
"name": "Cory Bartoletti",
"thumb_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/thumb/small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/medium/small_picture.jpg",
"created_at": "2022-11-16T09:40:21Z",
"logged_at": "2022-11-16T09:40:21Z"
},
"relationships": {
"unit": {
"data": {
"id": "81",
"type": "units"
}
},
"user": {
"data": {
"id": "44",
"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": "b19c2379-2764-473f-812e-04f94a0c7512",
"delivery_guid": "b307037c-95f9-4633-9d04-54e72cc0e053",
"name": "Lisandra Murazik",
"thumb_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/thumb/small_picture.jpg",
"medium_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/medium/small_picture.jpg",
"created_at": "2022-11-16T09:40:21Z",
"logged_at": "2022-11-16T09:40:21Z"
},
"relationships": {
"unit": {
"data": {
"id": "81",
"type": "units"
}
},
"user": {
"data": {
"id": "44",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/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-1668591622-c0cf94478c01d0247616b02b19635b86/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-1668591622-c0cf94478c01d0247616b02b19635b86/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": "52d67ecd-98b6-43d8-a9d4-1a6f88c43c30",
"created_at": "2022-11-16T09:44:05Z"
}
}
}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": "11f15eb7-9ec3-4df6-bf75-32fa7c5c6898",
"created_at": "2022-11-16T09:44:06Z"
}
}
}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": "52",
"type": "users",
"attributes": {
"name": "Randy Franecki",
"first_name": "Randy",
"last_name": "Franecki",
"contact_preference": "phone_call",
"thumb_url": null,
"medium_url": null,
"sip_username": "52",
"email": "aurelio@weinatlebsack.co",
"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": "53",
"type": "users",
"attributes": {
"name": "Lawerence Rodriguez",
"first_name": "Lawerence",
"last_name": "Rodriguez",
"contact_preference": "phone_call",
"thumb_url": null,
"medium_url": null,
"sip_username": "53",
"email": "doyle@metz.name",
"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": "Huels Group-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": "64995 Garland Villages",
"address_2": "Kerrifort, TX 92027-0780",
"city": "Kerrifort",
"state": "Texas",
"zip_code": "92027-0780",
"phone_number": "234-666-0978 x874",
"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": "Chani 50",
"nfc": {
"uuid": "549224ff-9b6e-4339-b1c0-ede3f0e50659"
}
}
}
]
}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": "54",
"attributes": {
"last_name": "Baker"
}
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "54",
"type": "users",
"attributes": {
"name": "Rachal Baker",
"first_name": "Rachal",
"last_name": "Baker",
"contact_preference": "phone_call",
"thumb_url": null,
"medium_url": null,
"sip_username": "54",
"email": "edgardo_boyle@blickwyman.io",
"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": "55",
"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": "392abda6-932d-46a3-a156-ab3e90daa3cd",
"delivery_guid": "3ac73fe9-1b72-40b7-b394-eb945258c1f1",
"name": "Mrs. Virgen Connelly",
"created_at": "2022-11-16T09:40:21Z",
"logged_at": "2022-11-16T09:40:21Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "69",
"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": "0c232e3f-2670-4e36-a282-2d58e94f46ad",
"delivery_guid": "18bfdf72-7071-4aa3-8f1e-4c64a41873e5",
"name": "Robena Gleason",
"created_at": "2022-11-16T09:40:21Z",
"logged_at": "2022-11-16T09:40:21Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "69",
"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": "e0fa46da-55e8-455b-b295-9aa5e22735ad",
"delivery_guid": "ac70b95d-fde4-467b-a5ae-32bced36deb9",
"name": "Mrs. Paige Cole",
"created_at": "2022-11-16T09:40:21Z",
"logged_at": "2022-11-16T09:40:21Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "69",
"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": "fc300685-e598-4b6a-b2f3-2b10f98095ee",
"delivery_guid": "c8babb93-ac37-44cc-811b-0f7babf54f5f",
"name": "Jeremiah O'Conner",
"created_at": "2022-11-16T09:40:21Z",
"logged_at": "2022-11-16T09:40:21Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "69",
"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": "0c0a031b-68b2-40f2-b893-93f8f676dfcd",
"delivery_guid": "446a9e99-e93b-41d9-a879-e85a98f7faef",
"name": "Fannie Ullrich",
"created_at": "2022-11-16T09:40:21Z",
"logged_at": "2022-11-16T09:40:21Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "69",
"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": "1c20b49f-3e3e-44dd-81b6-5c80df6e6622",
"delivery_guid": "660966f1-6805-4eec-ae27-285d3c9737a1",
"name": "Ms. Rudolph Barton",
"created_at": "2022-11-16T09:40:21Z",
"logged_at": "2022-11-16T09:40:21Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "69",
"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": "797f2776-463e-41c0-9c53-ffec15a58778",
"delivery_guid": "9d682f4e-a64f-405e-8667-ea9d3e094d94",
"name": "Awilda Monahan",
"created_at": "2022-11-16T09:40:21Z",
"logged_at": "2022-11-16T09:40:21Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "69",
"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": "455c1e94-a7c2-4cb7-91d8-bd50f95b21dc",
"delivery_guid": "7a652c80-780d-4e18-87b8-5ce13aa528b6",
"name": "Dr. Minh Abernathy",
"created_at": "2022-11-16T09:40:21Z",
"logged_at": "2022-11-16T09:40:21Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "69",
"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": "90345c46-0ed6-46c4-b3de-45d8ab9a04bb",
"delivery_guid": "91cfbd16-1f8f-470d-937c-ab2a9e0436cf",
"name": "Albert Schamberger",
"created_at": "2022-11-16T09:40:21Z",
"logged_at": "2022-11-16T09:40:21Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "69",
"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": "218e1bfb-01b9-47ae-95de-222d6057672f",
"delivery_guid": "9b616d6b-9a03-4301-88b6-c84cfa88e45a",
"name": "Gaylord McGlynn",
"created_at": "2022-11-16T09:40:21Z",
"logged_at": "2022-11-16T09:40:21Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "69",
"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": "4adb30e8-596d-4fde-9aff-aab3625e5979",
"delivery_guid": "3b79a6e3-bc1d-489e-8f26-c492afb30ba4",
"name": "Reinaldo Kunze",
"created_at": "2022-11-16T09:40:21Z",
"logged_at": "2022-11-16T09:40:21Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "69",
"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": "92a211ca-19d3-46ee-806a-aa27742974e1",
"delivery_guid": "6607e1cc-0ee9-448d-8a91-e00234061a74",
"name": "Robbie Shanahan",
"created_at": "2022-11-16T09:40:21Z",
"logged_at": "2022-11-16T09:40:21Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "69",
"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": "e24a85e3-764f-4b45-ac13-13e38733d85f",
"delivery_guid": "a9a6e58e-ff1a-4243-9473-dac43d15bd0a",
"name": "Lupe Bashirian",
"created_at": "2022-11-16T09:40:21Z",
"logged_at": "2022-11-16T09:40:21Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "69",
"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": "cc5b1461-d4c1-482f-9403-c195d52dea34",
"delivery_guid": "a93ece93-3c70-4900-85d6-2b915c78c34c",
"name": "Denny Marquardt Sr.",
"created_at": "2022-11-16T09:40:21Z",
"logged_at": "2022-11-16T09:40:21Z",
"thumb_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg",
"medium_url": "/assets/no_pic-8244a33d73b6a6668863761ddfbf8baa65f32869c273f8eba97bb8478c9a1d39.jpg"
},
"relationships": {
"unit": {
"data": {
"id": "263",
"type": "units"
}
},
"user": {
"data": {
"id": "69",
"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-11-16T09:44:19+00:00",
"ends_at": "2022-11-18T09:44:14+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-11-16T09:44:19Z",
"ends_at": "2022-11-18T09:44:14Z",
"time_from": "09:44",
"time_to": "09:44",
"kind": "custom",
"start_date": "2022-11-16",
"end_date": "2022-11-18",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-1lay5uw.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "738992",
"instructions_url": "http://user.butterflymx.test/public/jakubowski-macejkovic-133/virtual_keys/7/9e17d164ab28e1adbc42c99792da1583",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-iterw.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "742120",
"instructions_url": "http://user.butterflymx.test/public/jakubowski-macejkovic-133/virtual_keys/8/d0f65680f77e37ad25ea3707e7293bc1",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
},
{
"id": "2",
"type": "keypads",
"attributes": {
"name": "Hwi Noree 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-11-16T09:44:23+00:00",
"ends_at": "2022-11-18T09:44:18+00:00",
"recipients": [
"test@example.com",
"+12345678901"
],
"key_locker": {
"id": 2,
"compartment": "Q27"
}
},
"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-11-16T09:44:23Z",
"ends_at": "2022-11-18T09:44:18Z",
"time_from": "09:44",
"time_to": "09:44",
"kind": "custom",
"start_date": "2022-11-16",
"end_date": "2022-11-18",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-1s59vx7.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "664205",
"instructions_url": "http://user.butterflymx.test/public/wolf-group-135/virtual_keys/9/f2e0f2763ea3af07aacb56d78363a08e",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-1agv6za.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "794352",
"instructions_url": "http://user.butterflymx.test/public/wolf-group-135/virtual_keys/10/98be0ba35c9b334674ad4a8783745bb5",
"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-11-16T09:44:26+00:00",
"ends_at": "2022-11-18T09:44:21+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-11-16T09:44:26Z",
"ends_at": "2022-11-18T09:44:21Z",
"time_from": "09:44",
"time_to": "09:44",
"kind": "custom",
"start_date": "2022-11-16",
"end_date": "2022-11-18",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-11bpsf5.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "709538",
"instructions_url": "http://user.butterflymx.test/public/hegmann-inc-176/virtual_keys/11/c221240cdea0e1c3fe7efe45fd6081e4",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-1dc8kho.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "420610",
"instructions_url": "http://user.butterflymx.test/public/hegmann-inc-176/virtual_keys/12/a5243819f824fe8a71aee8c812315747",
"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-11-16T09:44:30+00:00",
"ends_at": "2022-11-18T09:44:25+00:00",
"recipients": [
"test@example.com",
"+12345678901"
],
"key_locker": {
"id": 4,
"compartment_id": 62
}
},
"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-11-16T09:44:30Z",
"ends_at": "2022-11-18T09:44:25Z",
"time_from": "09:44",
"time_to": "09:44",
"kind": "custom",
"start_date": "2022-11-16",
"end_date": "2022-11-18",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-1edd3l9.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "591842",
"instructions_url": "http://user.butterflymx.test/public/bruen-and-sons-217/virtual_keys/13/7f5e8321030ccce018d0148cb37ea491",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-1kctg2d.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "811726",
"instructions_url": "http://user.butterflymx.test/public/bruen-and-sons-217/virtual_keys/14/f120f4a0537546406db13fb81a0b6a0d",
"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-11-16T09:44:33+00:00",
"ends_at": "2022-11-18T09:44:28+00:00",
"recipients": [
"test@example.com",
"+12345678901"
],
"key_locker": {
"id": 5,
"compartment_id": 93,
"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-11-16T09:44:33Z",
"ends_at": "2022-11-18T09:44:28Z",
"time_from": "09:44",
"time_to": "09:44",
"kind": "custom",
"start_date": "2022-11-16",
"end_date": "2022-11-18",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-1vlyb7h.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "160684",
"instructions_url": "http://user.butterflymx.test/public/stokes-roob-258/virtual_keys/15/e236b4b42f5f912ceebf3e51bd1226bb",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-1l6m9xl.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "639455",
"instructions_url": "http://user.butterflymx.test/public/stokes-roob-258/virtual_keys/16/4872696631c21f8c27c58007240c1e2d",
"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-11-16T09:44:37+00:00",
"ends_at": "2022-11-18T09:44:32+00:00",
"recipients": [
"test@example.com",
"+12345678901"
],
"key_locker": {
"id": 6,
"compartment_id": 106
},
"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-11-16T09:44:37Z",
"ends_at": "2022-11-18T09:44:32Z",
"time_from": "09:44",
"time_to": "09:44",
"kind": "custom",
"start_date": "2022-11-16",
"end_date": "2022-11-18",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-3762tz.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "910742",
"instructions_url": "http://user.butterflymx.test/public/weissnat-hauck-299/virtual_keys/17/bbd129eb2c817cf2e19121ce376b8208",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-1jw0ycs.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "930540",
"instructions_url": "http://user.butterflymx.test/public/weissnat-hauck-299/virtual_keys/18/65042070744ba2407235db172fd7b323",
"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-11-16T09:44:37+00:00",
"ends_at": "2022-11-18T09:44:32+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-11-16T09:44:37Z",
"ends_at": "2022-11-18T09:44:32Z",
"time_from": "09:44",
"time_to": "09:44",
"kind": "custom",
"start_date": "2022-11-16",
"end_date": "2022-11-18",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-no8gyu.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "626108",
"instructions_url": "http://user.butterflymx.test/public/leuschke-johns-and-fisher-340/virtual_keys/19/7a0faa2905a4953b4c5c3915b052fb70",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-nxn4ef.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "738699",
"instructions_url": "http://user.butterflymx.test/public/leuschke-johns-and-fisher-340/virtual_keys/20/c68ec1d27802954dc8f27f4a16cafdea",
"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-11-18T09:44:34+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": "Internal Community-Services Engineer 19",
"weekdays": [],
"starts_at": "2022-11-16T09:44:42Z",
"ends_at": "2022-11-16T10:44:42Z",
"time_from": "09:44",
"time_to": "10:44",
"kind": "custom",
"start_date": "2022-11-16",
"end_date": "2022-11-16",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": []
},
"devices": {
"data": []
}
}
},
{
"id": "26",
"type": "keychains",
"attributes": {
"name": "Retail Officer 18",
"weekdays": [],
"starts_at": "2022-11-16T09:44:41Z",
"ends_at": "2022-11-16T10:44:41Z",
"time_from": "09:44",
"time_to": "10:44",
"kind": "custom",
"start_date": "2022-11-16",
"end_date": "2022-11-16",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": []
},
"devices": {
"data": []
}
}
},
{
"id": "25",
"type": "keychains",
"attributes": {
"name": "Farming Technician 17",
"weekdays": [],
"starts_at": "2022-11-16T09:44:41Z",
"ends_at": "2022-11-16T10:44:41Z",
"time_from": "09:44",
"time_to": "10:44",
"kind": "custom",
"start_date": "2022-11-16",
"end_date": "2022-11-16",
"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": "IT Designer 22",
"weekdays": [],
"starts_at": "2022-11-16T09:44:42Z",
"ends_at": "2022-11-16T10:44:42Z",
"time_from": "09:44",
"time_to": "10:44",
"kind": "custom",
"start_date": "2022-11-16",
"end_date": "2022-11-16",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": []
},
"devices": {
"data": []
}
}
},
{
"id": "29",
"type": "keychains",
"attributes": {
"name": "Marketing Administrator 21",
"weekdays": [],
"starts_at": "2022-11-16T09:44:42Z",
"ends_at": "2022-11-16T10:44:42Z",
"time_from": "09:44",
"time_to": "10:44",
"kind": "custom",
"start_date": "2022-11-16",
"end_date": "2022-11-16",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": []
},
"devices": {
"data": []
}
}
},
{
"id": "28",
"type": "keychains",
"attributes": {
"name": "Principal Design Analyst 20",
"weekdays": [],
"starts_at": "2022-11-16T09:44:42Z",
"ends_at": "2022-11-16T10:44:42Z",
"time_from": "09:44",
"time_to": "10:44",
"kind": "custom",
"start_date": "2022-11-16",
"end_date": "2022-11-16",
"allow_unit_access": false
},
"relationships": {
"virtual_keys": {
"data": [
{
"id": "24",
"type": "virtual_keys"
}
]
},
"devices": {
"data": []
}
}
}
],
"included": [
{
"id": "24",
"type": "virtual_keys",
"attributes": {
"name": "Miss Nelson Bergnaum",
"qr_code_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-op6cd5.png",
"email": "toby_harber@example.net",
"sms_number": "+12546220422",
"used_at": null,
"one_time_key_used_at": null,
"pin": "636374",
"instructions_url": "http://user.butterflymx.test/public/marks-torphy-362/virtual_keys/24/2555b413018f389a244bcc8df541533f",
"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": "Education Associate 23",
"weekdays": [],
"starts_at": "2022-11-16T09:44:43Z",
"ends_at": "2022-11-16T10:44:43Z",
"time_from": "09:44",
"time_to": "10:44",
"kind": "custom",
"start_date": "2022-11-16",
"end_date": "2022-11-16",
"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-11-16T09:44:54+00:00",
"ends_at": "2022-11-18T09:44:49+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-11-16T09:44:54Z",
"ends_at": "2022-11-18T09:44:49Z",
"time_from": "09:44",
"time_to": "09:44",
"kind": "one_time",
"start_date": "2022-11-16",
"end_date": "2022-11-18",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-166yvgc.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "469529",
"instructions_url": "http://user.butterflymx.test/public/murray-schneider-385/virtual_keys/27/d39a68a95ba4ca7b3331f935516927d7",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-nzx8gy.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "767825",
"instructions_url": "http://user.butterflymx.test/public/murray-schneider-385/virtual_keys/28/dccdb045d3bfb13a5ed98fc9c5c307fc",
"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-11-16T09:44:55+00:00",
"ends_at": "2022-11-18T09:44:50+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-11-16T09:44:55Z",
"ends_at": "2022-11-18T09:44:50Z",
"time_from": "09:44",
"time_to": "09:44",
"kind": "one_time",
"start_date": "2022-11-16",
"end_date": "2022-11-18",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-1vmwb6p.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "026032",
"instructions_url": "http://user.butterflymx.test/public/ledner-and-sons-386/virtual_keys/29/0dc6cd3ce6ec9341412206b73e86c44c",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-1uzcwhi.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "713683",
"instructions_url": "http://user.butterflymx.test/public/ledner-and-sons-386/virtual_keys/30/8c0212394d2500cea949d34db5432f94",
"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-11-18T09:44:51+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-11-16",
"end_date": "2022-11-18",
"time_from": "11:20",
"time_to": "11:50",
"weekdays": [
"wed",
"sat"
],
"recipients": [
"test@example.com",
"+12345678901"
],
"creator": {
"id": 138,
"account_id": 138,
"first_name": "Agripina",
"last_name": "Macejkovic",
"created_at": "2022-11-16T09:44:55Z",
"updated_at": "2022-11-16T09:44:55Z",
"email_cache": "janey@carroll.co",
"qr_key_enabled": true,
"contact_preference": "phone_call",
"confirmed_at_cache": null,
"deleted_at": null,
"devices_count": 0,
"status": "registered",
"panel_status_report": false,
"invited_at": null,
"language": "en",
"download_app_page_shown": true,
"privacy_consent_given": true,
"anonymized": false
}
},
"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-11-16T11:20:00Z",
"ends_at": "2022-11-18T11:50:00Z",
"time_from": "11:20",
"time_to": "11:50",
"kind": "recurring",
"start_date": "2022-11-16",
"end_date": "2022-11-18",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-oi0ych.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "683459",
"instructions_url": "http://user.butterflymx.test/public/breitenberg-group-400/virtual_keys/33/66be7e80b2c39101bcf0ac1261ab32b3",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-qt57kp.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "719180",
"instructions_url": "http://user.butterflymx.test/public/breitenberg-group-400/virtual_keys/34/e5a6189074c397c571fbb84b3d39d323",
"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-11-16",
"end_date": "2022-11-18",
"time_from": "11:20",
"time_to": "11:50",
"weekdays": [
"wed",
"sat"
],
"recipients": [
"test@example.com",
"+12345678901"
],
"creator": {
"id": 140,
"account_id": 140,
"first_name": "Alexis",
"last_name": "Keebler",
"created_at": "2022-11-16T09:44:56Z",
"updated_at": "2022-11-16T09:44:56Z",
"email_cache": "phylis@conn.co",
"qr_key_enabled": true,
"contact_preference": "phone_call",
"confirmed_at_cache": null,
"deleted_at": null,
"devices_count": 0,
"status": "registered",
"panel_status_report": false,
"invited_at": null,
"language": "en",
"download_app_page_shown": true,
"privacy_consent_given": true,
"anonymized": false
}
},
"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-11-16T11:20:00Z",
"ends_at": "2022-11-18T11:50:00Z",
"time_from": "11:20",
"time_to": "11:50",
"kind": "recurring",
"start_date": "2022-11-16",
"end_date": "2022-11-18",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-1kakhq8.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "960142",
"instructions_url": "http://user.butterflymx.test/public/kulas-huels-and-ankunding-401/virtual_keys/35/4783b872c5cf234fba5f9047efba5fc9",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-z1gu9o.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "562350",
"instructions_url": "http://user.butterflymx.test/public/kulas-huels-and-ankunding-401/virtual_keys/36/31253e139d89512faf3b34fa2912ccdb",
"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-11-16",
"end_date": "2022-11-18",
"time_from": "11:20",
"time_to": "11:50",
"weekdays": [
"wed",
"sat"
],
"recipients": [
"test@example.com",
"+12345678901"
],
"creator": {
"id": 142,
"account_id": 142,
"first_name": "Dion",
"last_name": "Kub",
"created_at": "2022-11-16T09:44:57Z",
"updated_at": "2022-11-16T09:44:57Z",
"email_cache": "lane_nienow@oconnell.org",
"qr_key_enabled": true,
"contact_preference": "phone_call",
"confirmed_at_cache": null,
"deleted_at": null,
"devices_count": 0,
"status": "registered",
"panel_status_report": false,
"invited_at": null,
"language": "en",
"download_app_page_shown": true,
"privacy_consent_given": true,
"anonymized": false
}
},
"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-11-16T11:20:00Z",
"ends_at": "2022-11-18T11:50:00Z",
"time_from": "11:20",
"time_to": "11:50",
"kind": "recurring",
"start_date": "2022-11-16",
"end_date": "2022-11-18",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-18j5cc9.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "899401",
"instructions_url": "http://user.butterflymx.test/public/hackett-llc-402/virtual_keys/37/bda94cbeace04bb5e942d6747e263c3b",
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-26pryq.png",
"email": null,
"sms_number": "+12345678901",
"used_at": null,
"one_time_key_used_at": null,
"pin": "978659",
"instructions_url": "http://user.butterflymx.test/public/hackett-llc-402/virtual_keys/38/8488cc3a7bec4e1ce1623437aee42dfc",
"sent_at": null,
"synced_with_remote_lock": false
},
"relationships": {
"door_releases": {
"data": []
}
}
},
{
"id": "52",
"type": "panels",
"attributes": {
"name": "Shadout Mapes 177",
"nfc": {
"uuid": "60be4035-d859-455b-89a0-bdb0e5ea88e3"
}
},
"relationships": {
"building": {
"data": {
"id": "1379",
"type": "buildings"
}
}
}
},
{
"id": "53",
"type": "panels",
"attributes": {
"name": "Edric 178",
"nfc": {
"uuid": "39ea6af5-ace3-46de-a8ee-d57d620ba29d"
}
},
"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-11-16",
"end_date": "2022-11-18",
"time_from": "11:20",
"time_to": "11:50",
"weekdays": [
"wed",
"sat"
],
"recipients": [
"test@example.com",
"+12345678901"
],
"creator": {
"id": 144,
"account_id": 144,
"first_name": "Karin",
"last_name": "Bogan",
"created_at": "2022-11-16T09:44:59Z",
"updated_at": "2022-11-16T09:44:59Z",
"email_cache": "jefferson.graham@shieldslang.name",
"qr_key_enabled": true,
"contact_preference": "phone_call",
"confirmed_at_cache": null,
"deleted_at": null,
"devices_count": 0,
"status": "registered",
"panel_status_report": false,
"invited_at": null,
"language": "en",
"download_app_page_shown": true,
"privacy_consent_given": true,
"anonymized": false
}
},
"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-1668591622-c0cf94478c01d0247616b02b19635b86/store/original/qr_code_20221116-1030-1qcm6bf.png",
"email": "test@example.com",
"sms_number": null,
"used_at": null,
"one_time_key_used_at": null,
"pin": "901580",
"instructions_url": "http://user.butterflymx.test/public/breitenberg-group-396/virtual_keys/31/07f2ba39cc41a675eb0798da477fee93",
"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": "9f5baafa-ad3b-4cb2-b570-b346266b4f49"
}
}
}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": "93b23ca7-e164-4d05-9078-9a2d508bc739"
}
}
}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": "2c4af381-93d9-4e98-ada0-59797d44cb71"
}
}
}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": "bd226e66-1598-4e2d-8159-179bf61d01d8"
}
}
}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": "1860013c-a8fb-4cf9-a497-cd856ddb42cb"
}
}
}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": "7c8c04c4-1e4a-4f24-98fe-2c89c070e310"
}
}
}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": "825ef0d0-bbb7-4f00-a2d4-e2899f4ffdab"
}
}
}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": "a3826eb9-ede3-430e-b120-8de4f88f3eea"
}
}
}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": "cbee3b59-051d-46be-bb65-f60a142758ed"
}
}
}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": "524ee0a2-3278-49ab-8f0c-200b219126f4"
}
}
}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-11-16T09:45:00Z",
"inactive_at": null,
"qr_key_enabled": true,
"delivery_pass_instructions": null,
"directory_message": "Global Banking Supervisor",
"display_name": "Ms. Sherrill Williamson",
"display_name_strategy": "building",
"display_first_name": "Mrs. Melany Schuster",
"display_last_name": "Lupe Barrows",
"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": "151",
"type": "users"
}
}
}
},
{
"id": "2294",
"type": "tenants",
"attributes": {
"active_at": "2022-11-16T09:45:00Z",
"inactive_at": null,
"qr_key_enabled": true,
"delivery_pass_instructions": null,
"directory_message": "Chief IT Coordinator",
"display_name": "Avery Ratke",
"display_name_strategy": "building",
"display_first_name": "Stacey Pollich",
"display_last_name": "Mario Halvorson",
"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": "150",
"type": "users"
}
}
}
},
{
"id": "2293",
"type": "tenants",
"attributes": {
"active_at": "2022-11-16T09:45:00Z",
"inactive_at": null,
"qr_key_enabled": true,
"delivery_pass_instructions": null,
"directory_message": "Design Administrator",
"display_name": "Jenell Schimmel",
"display_name_strategy": "building",
"display_first_name": "Pamela Lebsack I",
"display_last_name": "Forest Davis",
"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": "149",
"type": "users"
}
}
}
}
],
"included": [
{
"id": "151",
"type": "users",
"attributes": {
"name": "Beau Thompson",
"first_name": "Beau",
"last_name": "Thompson",
"contact_preference": "phone_call",
"thumb_url": null,
"medium_url": null,
"sip_username": "151",
"registration_status": "registered",
"email": "armandina.pacocha@cain.co",
"sms_phone_number": null,
"phone_number": null
}
},
{
"id": "150",
"type": "users",
"attributes": {
"name": "Edelmira Herman",
"first_name": "Edelmira",
"last_name": "Herman",
"contact_preference": "phone_call",
"thumb_url": null,
"medium_url": null,
"sip_username": "150",
"registration_status": "registered",
"email": "vernon.gorczany@white.org",
"sms_phone_number": null,
"phone_number": null
}
},
{
"id": "149",
"type": "users",
"attributes": {
"name": "Gale Fritsch",
"first_name": "Gale",
"last_name": "Fritsch",
"contact_preference": "phone_call",
"thumb_url": null,
"medium_url": null,
"sip_username": "149",
"registration_status": "registered",
"email": "tiara.macejkovic@okunevaswift.org",
"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-11-16T09:45:00Z",
"inactive_at": null,
"qr_key_enabled": true,
"delivery_pass_instructions": null,
"directory_message": "Dynamic Hospitality Supervisor",
"display_name": "Selma Klocko",
"display_name_strategy": "building",
"display_first_name": "Odis Cormier",
"display_last_name": "Melissa Armstrong",
"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": "339",
"type": "units"
}
},
"user": {
"data": {
"id": "153",
"type": "users"
}
}
}
},
"included": [
{
"id": "153",
"type": "users",
"attributes": {
"name": "Cesar Schimmel",
"first_name": "Cesar",
"last_name": "Schimmel",
"contact_preference": "phone_call",
"thumb_url": null,
"medium_url": null,
"sip_username": "153",
"registration_status": "registered",
"email": "casey@goldner.io",
"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": "loren.effertz@hegmannmckenzie.net",
"active_at": "2022-11-16T09:45:01Z"
},
"type": "tenants",
"relationships": null
}
}Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "2297",
"type": "tenants",
"attributes": {
"active_at": "2022-11-16T09:45:01Z",
"inactive_at": null,
"qr_key_enabled": true,
"delivery_pass_instructions": null,
"directory_message": null,
"display_name": "Resident",
"display_name_strategy": "building",
"display_first_name": "Resident",
"display_last_name": " ",
"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": "155",
"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-11-16T09:45:01Z"
},
"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-11-16T09:45:01Z",
"inactive_at": null,
"qr_key_enabled": true,
"delivery_pass_instructions": null,
"directory_message": "Marketing Engineer",
"display_name": "Reed Hills",
"display_name_strategy": "building",
"display_first_name": "Beatriz Rau",
"display_last_name": "Ms. Brain Padberg",
"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": "159",
"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/ortiz-and-sons-415/tour_schedules
Requests
GET /v3/tours/ortiz-and-sons-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": "ortiz-and-sons-415",
"name": "Ortiz and Sons-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": "860 Ilse Stravenue",
"address_2": "Lanechester, WY 50078",
"city": "Lanechester",
"state": "Wyoming",
"zip_code": "50078",
"phone_number": "1-774-177-7669 x917"
},
"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: ortiz-and-sons-415
POST /v3/tours/mayert-kuhn-417/tour_schedules
Requests
POST /v3/tours/mayert-kuhn-417/tour_schedules
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"name": "Mayert-Kuhn-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": "Mayert-Kuhn-417 Tour",
"email": "tour@example.com",
"starts_at": "2020-12-14T12:00:00Z",
"ends_at": "2020-12-14T13:00:00Z",
"uuid": "4ebd284b-f3b5-4f2f-975c-e3a14a0b3107",
"status": "confirmed",
"qr_key_public_url": "http://user.butterflymx.test/public/mayert-kuhn-417/virtual_keys/39/4d38b170c550afb13f82c1d0a112ebe5",
"pin": "573074",
"qr_key_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/medium/qr_code_20201214-1030-1t9qsd3.png",
"phone_number": "(555) 555-1234",
"building_handle": "mayert-kuhn-417",
"building_name": "Mayert-Kuhn-417",
"building_address": {
"country": "us",
"address_1": "3924 Powlowski Neck",
"address_2": "Starkland, KS 29584-7110",
"city": "Starkland",
"state": "Kansas",
"zip_code": "29584-7110",
"phone_number": "932.908.2428"
},
"tour_units": [],
"day_of_tour_url": "http://selftours.butterflymx.test/tour/4ebd284b-f3b5-4f2f-975c-e3a14a0b3107",
"keychains": [],
"key_locker_in_use": false
}
}
}POST /v3/tours/hansen-pacocha-and-wolff-419/tour_schedules
Headers
Accept: application/vnd.api+json
Content-Type: application/vnd.api+jsonBody
{
"data": {
"attributes": {
"name": "Hansen, Pacocha and Wolff-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: mayert-kuhn-417
GET /v3/tours/48f7ae2d-2ca9-416f-84f4-76b8f929f7ca
Requests
GET /v3/tours/48f7ae2d-2ca9-416f-84f4-76b8f929f7ca
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": "48f7ae2d-2ca9-416f-84f4-76b8f929f7ca",
"status": "confirmed",
"qr_key_public_url": null,
"pin": null,
"qr_key_image_url": null,
"phone_number": "(556) 136-4987 x673",
"building_handle": "donnelly-wehner-421",
"building_name": "Donnelly-Wehner-421",
"building_address": {
"country": "us",
"address_1": "836 Alden Ridge",
"address_2": "West Alonso, KS 48778-7531",
"city": "West Alonso",
"state": "Kansas",
"zip_code": "48778-7531",
"phone_number": "1-569-993-9086 x277"
},
"tour_units": [],
"day_of_tour_url": "http://selftours.butterflymx.test/tour/48f7ae2d-2ca9-416f-84f4-76b8f929f7ca",
"keychains": [],
"key_locker_in_use": false
}
}
}ShowGET/v3/tours/{uuid}
URI Parameters
- uuid
string(required) Example: 48f7ae2d-2ca9-416f-84f4-76b8f929f7ca
PATCH /v3/tours/1014890c-0341-41aa-b0c5-33e4f7049364
Requests
PATCH /v3/tours/1014890c-0341-41aa-b0c5-33e4f7049364
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": "1014890c-0341-41aa-b0c5-33e4f7049364",
"status": "rescheduled",
"qr_key_public_url": "http://user.butterflymx.test/public/cronin-windler-423/virtual_keys/40/38ec9c72f2b0afcf0516a5b11331d7ee",
"pin": "190631",
"qr_key_image_url": "https://bmx-rails-staging.s3.amazonaws.com/system/uploads/test-1-1668591622-c0cf94478c01d0247616b02b19635b86/store/medium/qr_code_20201214-1030-19dwclu.png",
"phone_number": "(306) 566-1021",
"building_handle": "cronin-windler-423",
"building_name": "Cronin-Windler-423",
"building_address": {
"country": "us",
"address_1": "91990 Henry Plains",
"address_2": "Watersmouth, MI 28523-1556",
"city": "Watersmouth",
"state": "Michigan",
"zip_code": "28523-1556",
"phone_number": "(661) 009-6932 x81712"
},
"tour_units": [],
"day_of_tour_url": "http://selftours.butterflymx.test/tour/1014890c-0341-41aa-b0c5-33e4f7049364",
"keychains": [],
"key_locker_in_use": false
}
}
}UpdatePATCH/v3/tours/{uuid}
URI Parameters
- uuid
string(required) Example: 1014890c-0341-41aa-b0c5-33e4f7049364
DELETE /v3/tours/36c5293f-4539-4262-8121-be765f86984f
Requests
DELETE /v3/tours/36c5293f-4539-4262-8121-be765f86984f
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": "36c5293f-4539-4262-8121-be765f86984f",
"status": "cancelled",
"qr_key_public_url": null,
"pin": null,
"qr_key_image_url": null,
"phone_number": "108.489.7628 x6251",
"building_handle": "kassulke-hahn-425",
"building_name": "Kassulke-Hahn-425",
"building_address": {
"country": "us",
"address_1": "8918 Carlene Union",
"address_2": "Josefamouth, TX 51722-1685",
"city": "Josefamouth",
"state": "Texas",
"zip_code": "51722-1685",
"phone_number": "(943) 986-2641"
},
"tour_units": [],
"day_of_tour_url": "http://selftours.butterflymx.test/tour/36c5293f-4539-4262-8121-be765f86984f",
"keychains": [],
"key_locker_in_use": false
}
}
}DeleteDELETE/v3/tours/{uuid}
URI Parameters
- uuid
string(required) Example: 36c5293f-4539-4262-8121-be765f86984f
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": "Franecki-Kunze-430",
"building_type": "multi_family",
"display_name_strategy": "anonymous",
"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": "59810 September Trafficway",
"address_2": "Andersonburgh, OR 32504-1774",
"city": "Andersonburgh",
"state": "Oregon",
"zip_code": "32504-1774",
"phone_number": "642-020-5234",
"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 16 Nov 2022