Create a room booking

POST

/rooms/{roomId}/bookings

Creates a new booking for the specified room

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "startTime": "2024-01-01T10:00:00.000Z",
    "durationInSeconds": 3600,
    "title": "Team Meeting",
    "description": "Weekly team sync meeting to discuss project updates",
    "attendees": [
        {
            "email": "john.doe@example.com"
        }
    ],
    "isPrivate": false
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://connect.deskbird.com/rooms//bookings' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "startTime": "2024-01-01T10:00:00.000Z",
    "durationInSeconds": 3600,
    "title": "Team Meeting",
    "description": "Weekly team sync meeting to discuss project updates",
    "attendees": [
        {
            "email": "john.doe@example.com"
        }
    ],
    "isPrivate": false
}'

Responses

🟢201Created

application/json

Room booking created successfully

Body

Example

{
    "attendees": [
        {
            "email": "john.doe@example.com"
        }
    ],
    "durationInSeconds": 3600,
    "id": "booking-123",
    "isCheckedIn": false,
    "isPrivate": false,
    "officeId": "office-123",
    "roomId": "room-123",
    "startTime": "2024-01-01T10:00:00Z",
    "title": "Team Meeting",
    "type": "occurrence",
    "userId": "user-123",
    "description": "Weekly team standup meeting"
}

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🟠409Conflict

Lists room bookings

Gets single room booking