Reserving a time

Reserve specific time for your customers.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

This endpoint allows one to reserve a timeslot, blocking others from booking it, for specified amount of time. When the duration passes, the time slot is “released” back and made available again, unless it is converted into a booking. The duration amount is customizable on the “Project'' Level.

Step-1: Configure Reservation Duration on Project

To reserve a time or slot you first need to configure your project with a default reservation time. You can also change this at any time.

Step-2: Send reservation request

Using v2/bookings/reserve endpoint send a request to reserve a time slot for specific duration. Once time slot is reserved your users wont be able to book this reserved time slot.

To create a booking for reserved time you must use the booking endpoint and pass a field called reservation_id which is the id returned from this v2/bookings/reserve endpoint.

Body Params
int32
required
Defaults to 30

Amount of time in seconds to reserve for given time slot

string
required

When the booking starts

string
required

When the booking ends

string

If you want to use the settings specified in the project. Any additional parameters in the request will override those set in the project

string
required

The ID of the resource being booked

string
required

The title of the booking

string
required

A description of the location of the booking

string
required

a description of the booking

customer
object

Customer info (depending on the chosen graph!) the customer is the person booking the resource.

string

Name of the flow graph you want to use. Please refer to our graph reference https://developers.timekit.io/reference/graphs

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json