Reservation Offerings API

List reservation offerings

List all reservation offerings for an account:

GET /reservation_offerings

Response

status: 200 OK
[
  {
    "id": 7,
    "sourceID": null,
    "name": "4me training environment",
    "created_at": "2020-07-09T20:34:33-05:00",
    "updated_at": "2020-07-09T20:34:51-05:00",
    "nodeID": "..."
  },
  {
    "id": 24,
    "sourceID": null,
    "name": "Conference Rooms",
    "created_at": "2020-07-10T20:24:05-05:00",
    "updated_at": "2020-07-13T04:19:48-05:00",
    "nodeID": "..."
  },
  {
    "id": 25,
    "sourceID": null,
    "name": "Pool Car",
    "created_at": "2020-07-11T17:38:13-05:00",
    "updated_at": "2020-07-11T18:17:53-05:00",
    "nodeID": "..."
  },
  "..."
]

The response contains these fields by default. Filtering and pagination are available to reduce/limit the collection of reservation offerings.

Predefined Filters

The following predefined filters are available:

Collection Fields

By default the following fields will appear in collections of reservation offerings:

id sourceID name created_at updated_at

Obtain a different set of fields using the ?fields= parameter.

Filtering

Filtering is available for the following fields:

id source sourceID name disabled created_at updated_at

Sorting

By default a collection of reservation offerings is sorted ascending by name.

The following fields are accepted by the ?sort= parameter:

id sourceID name created_at updated_at

Response

The response is similar to the response in List reservation offerings

Get a single reservation offering

GET /reservation_offerings/:id

Response

status: 200 OK
{
  "calendar": {
    "id": 50,
    "name": "24x7 (Monday through Sunday)",
    "nodeID": "..."
  },
  "created_at": "2020-07-09T20:34:33-05:00",
  "disabled": false,
  "filters": [],
  "id": 7,
  "initial_status": "confirmed",
  "max_advance_duration": null,
  "max_duration": 10080,
  "min_advance_duration": null,
  "min_duration": 240,
  "multi_day": true,
  "name": "4me training environment",
  "preparation_duration": null,
  "service_instance": {
    "id": 77,
    "name": "Service Management (4me) Production",
    "localized_name": "Service Management (4me) Production",
    "nodeID": "..."
  },
  "source": null,
  "sourceID": null,
  "step_duration": 240,
  "time_zone": "Central Time (US & Canada)",
  "updated_at": "2020-07-09T20:34:51-05:00",
  "nodeID": "..."
}

The response contains these fields.

Create a reservation offering

POST /reservation_offerings

When creating a new reservation offering these fields are available.

Response

status: 201 Created
{
  "brand": "...",
  "...": "..."
}

The response contains all fields of the created reservation offering and is similar to the response in Get a single reservation offering

Update a reservation offering

PATCH /reservation_offerings/:id

When updating a reservation offering these fields are available.

Response

status: 200 OK
{
  "brand": "...",
  "...": "..."
}

The response contains all fields of the updated reservation offering and is similar to the response in Get a single reservation offering

Fields

allow_repeat
Optional boolean, default: false — Whether it is allowed to create recurrent reservations for this offering.
disabled
Optional boolean, default: false — The Disabled box is checked when the reservation offering may not be related to a request template any more.
calendar
Required reference to Calendar — The Calendar field is used to select the Calendar that defines the hours during which the Configuration Items can be made available for temporary use.
created_at
Readonly datetime — The date and time at which the reservation offering was created.
filters
Optional array of strings — The Filters field allows filters to be selected that people, who are selecting a configuration item of the reservation offering, can use to limit the list of configuration items to only those that meet specific criteria, such as the configuration item’s product or site.
id
Readonly integer — The unique ID of the reservation offering.
initial_status
Required enum — The Initial status field is used to specify whether a reservation that was requested using the reservation offering is immediately confirmed after it has been submitted, or that an action (such as an approval) is still required before it can be confirmed. Valid values are:
  • pending: The requested reservation is awaiting confirmation.
  • confirmed: The requested reservation is confirmed.
max_advance_duration
Optional integer — The Max. advance duration field is used to specify how far in the future the start of a reservation is allowed to be scheduled using the reservation offering.
max_duration
Required integer — The Max. duration field is used to specify the maximum length of time for which a configuration item of the reservation offering can be reserved.
min_advance_duration
Optional integer — The Min. advance duration field is used to specify how much advance notice is needed from the moment a reservation is requested using the reservation offering and the start of the reservation. This is typically the time needed to prepare a configuration item of the reservation offering.
min_duration
Required integer — The Min. duration field is used to specify the minimum length of time for which a configuration item of the reservation offering can be reserved.
multi_day
Optional boolean, default: false — The Multi-day box is checked when a reservation request that uses the reservation offering is allowed to start on one day and end on another. When true the duration of a reservation that makes use of the reservation offering is defined by filling out the End field instead of the duration field.
name
Required string (max 128) — The Name field is used to enter a name for the reservation offering.
preparation_duration
Optional integer — The Preparation duration field is used to specify the amount of time needed to prepare a configuration item of the reservation offering for the next person who reserved it. People are not be able to request a reservation of a configuration item if it overlaps with the preparation duration of an existing reservation for the same configuration item.
service_instance
Required reference to Service Instance — The service instance field is used to select the Service Instance for which people need to be covered in order to be able to make use of the reservation offering.
source
Optional string (max 30) - See source
sourceID
Optional string (max 128) - See source
step_duration
Required integer — The Step duration field is used specify the time increments for the duration of a reservation that is requested using the reservation offering.
time_zone
Required time_zone — The Time zone field is used to select the time zone that applies to the selected calendar.
updated_at
Readonly datetime — The date and time of the last update of the team. If the team has no updates it contains the created_at value.