List Resources

Description

The resources (rooms and equipment) associated with an Enterprise Connect account can be listed via the resources endpoint.

This requires the Enterprise Connect authentication to have the service_account/resources/manage scope granted.

URL format

api.cronofy.com/v1/resources

Example request

GET /v1/resources HTTP/1.1
Host: api.cronofy.com
Content-Type: application/json; charset=utf-8

Example Response

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "resources": [
    {
      "email": "board-room-london@example.com",
      "name": "Board room (London)"
    },
    {
      "email": "board-room-madrid@example.com",
      "name": "Board room (Madrid)"
    },
    {
      "email": "3dprinter@example.com",
      "name": "3D Printer"
    },
    {
      "email": "vr-headset@example.com",
      "name": "Oculus Rift"
    }
  ]
}

Response parameters

resources.email #

The email address for the resource.

May be used to obtain access tokens for the resource calendar via Requesting Delegated Access.

resources.name #

The name defined for the resource by the Enterprise Connect account.

Exchange and Office 365 users will need to ensure that any resources are added to a room list in order for these resources to be viewable for details on how to configure this for Office 365 see: enabling room list distribution groups.

Cronofy Docs