Guest accounts are used to provide additional logins for RADIUS/RFID etc. authentication/the check-in API.

List guest accounts

GET https://:subdomain.cobot.me/api/guest_accounts

Returns a list of guest accounts of the space.

Authentication required

yes, additionally user must be a space admin

Scope required

read_guest_accounts

Example

GET https://co-up.cobot.me/api/guest_accounts

Response:

[
  {
    "id": "358bc2fd30c7bb0000a72ef786cc612b",
    "login": "joe",
    "expires_after": "2017/01/05 12:45:00 +0000"
  }
]

Show single guest account

GET https://:subdomain.cobot.me/api/guest_accounts/:id

Returns a single guest account of the space.

Authentication required

yes, additionally user must be a space admin

Scope required

read_guest_accounts

Example

GET https://co-up.cobot.me/api/guest_accounts/dce8ca410400c427cb4a3262e6874c9f

Response:

{
  "id": "358bc2fd30c7bb0000a72ef786cc612b",
  "login": "joe",
  "expires_after": "2017/01/05 12:45:00 +0000"
}

Create guest account

POST https://:subdomain.cobot.me/api/guest_accounts

Authentication required:

yes, additionally user must be a space admin

Scope required

write_guest_accounts

Creates a guest account with the given login/password and optional expiration.

Example:

POST https://co-up.cobot.me/api/guest_accounts

Body:

{
  "login": "joe",
  "password": "liyvasfiyfg4(lkbnsSS9#",
  "expires_after": "2018/01/05 12:45:00 +0000"
}

Response:

{
  "id": "358bc2fd30c7bb0000a72ef786cc612b",
  "login": "joe",
  "expires_after": "2018/01/05 12:45:00 +0000"
}

Returns 201 on success.

Delete guest account

DELETE https://:subdomain.cobot.me/api/guest_accounts/:id

Authentication required:

yes, additionally user must be a space admin

Scope required

write_guest_accounts

Example:

DELETE https://co-up.cobot.me/api/guest_accounts/358bc2fd30c7bb0000a72ef786cc612b

Returns 204 and no body.