Create Reservation | Legacy

Restriction: This API endpoint is not supported in the Free Trial cloud.

Creates a new device reservation.

URL

Copy
https://<your-cloud>.perfectomobile.com/services/reservations?operation=create&securityToken=value&resourceIds=value&startTime=value&endTime=value

Method

POST

Parameters

Name Type Default Description
securityToken* string
A unique cryptographic key assigned to an authorized user.
admin  boolean false true to allow users with administrative credentials to create reservations for users in their group.
note: users with administrative credentials can create reservations longer than the max time-frame.
note: not available on shared MCM.
resourceIds* string
A comma separated list of deviceId.
startTime* 

 

long
The reservation start time, measured in milliseconds, from midnight, January 1, 1970 UTC (standard UNIX time).**
* Use -1 to indicate current time.
endTime* long
The reservation end time, measured in milliseconds, from midnight, January 1, 1970 UTC (standard UNIX time).**
reservedTo  string
The user the device is reserved to. 
description  string
The reservation description (free text). 
responseFormat string json The format to use for the response: json, xml

* Mandatory parameter

** Use this Timestamp converter to create the required time stamp.

Response

The response contains the generated reservation ids and a system timestamp of the when the reservation was registered.

Copy

JSON response

{
    "reservationIds":["87640"],
    "info":{
        "creationTime":{
            "formatted":"2016-12-04T11:51:25Z",
            "millis":"1480852285681"        },
        "items":"1",
        "modelVersion":"2.6.0.0",
        "productVersion":"master",
        "time":"2016-12-04T11:51:25Z"    }
}