---
title: "Reserve a slot"
method: POST
path: "/v2/slots/reservations"
tags: ["Slots"]
---

# Reserve a slot

`POST /v2/slots/reservations`

Make a slot not available for others to book for a certain period of time. If you authenticate using oAuth credentials, api key or access token
    then you can also specify custom duration for how long the slot should be reserved for (defaults to 5 minutes).
    
    <Note>Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.</Note>

## Headers

- `cal-api-version` string, required
- `Authorization` string
- `x-cal-client-id` string

## Request body

- ReserveSlotInput20240904
  - `eventTypeId` number, required — The ID of the event type for which slot should be reserved.
  - `slotStart` string, required — ISO 8601 datestring in UTC timezone representing available slot.
  - `slotDuration` number — By default slot duration is equal to event type length, but if you want to reserve a slot for an event type that has a variable length you can specify it here as a number in minutes. If you don't have this set explicitly that event type can have one of many lengths you can omit this.
  - `reservationDuration` number — ONLY for authenticated requests with api key, access token or OAuth credentials (ID + secret). For how many minutes the slot should be reserved - for this long time noone else can book this event type at `start` time. If not provided, defaults to 5 minutes.

## Response `201`

- ReserveSlotOutputResponse20240904
  - `status` 'success' | 'error', required
  - `data` ReserveSlotOutput20240904, required
    - `eventTypeId` number, required — The ID of the event type for which slot was reserved.
    - `slotStart` string, required — ISO 8601 datestring in UTC timezone representing available slot.
    - `slotEnd` string, required — ISO 8601 datestring in UTC timezone representing slot end.
    - `slotDuration` number, required — By default slot duration is equal to event type length, but if you want to reserve a slot for an event type that has a variable length you can specify it here. If you don't have this set explicitly that event type can have one of many lengths you can omit this.
    - `reservationUid` string, required — The unique identifier of the reservation. Use it to update, get or delete the reservation.
    - `reservationDuration` number, required — For how many minutes the slot is reserved - for this long time noone else can book this event type at `start` time.
    - `reservationUntil` string, required — ISO 8601 datestring in UTC timezone representing time until which the slot is reserved.

---

[API](https://skmtc.net/calcom/apis/cal-diy-api-v2.md) · [All operations](https://skmtc.net/calcom/apis/cal-diy-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/calcom/cal-diy-api-v2/revisions/16de9d3eb7b3/schema)