Updates a room booking

PATCH

/rooms/{roomId}/bookings/{bookingId}

Updates an existing room booking's details. Allows modification of start time, duration, title, description, privacy status, user assignment, and attendees. Private bookings cannot be updated - attempting to update a private booking will result in a 403 Forbidden error. Verifies that the booking belongs to the authenticated user's company before allowing updates.

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 - Updated",
    "description": "Updated meeting description",
    "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 PATCH '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 - Updated",
    "description": "Updated meeting description",
    "attendees": [
        {
            "email": "john.doe@example.com"
        }
    ],
    "isPrivate": false
}'

Responses

🟢200OK

application/json

Room booking updated successfully

Bodyapplication/json

Example

{
    "createdAt": "2024-01-01T09:00:00.000Z",
    "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",
    "status": "accepted",
    "title": "Team Meeting",
    "type": "occurrence",
    "userId": "user-123",
    "updatedAt": "2024-01-01T09:30:00.000Z",
    "description": "Weekly team standup meeting"
}

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Gets a single room booking

Checks in to a room booking