Skip to main content
POST
Book an advance desk reservation

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Body

application/json
deviceSipUsername
string
required

SIP credential username of the shared desk being booked.

Required string length: 3 - 128
Pattern: ^[a-zA-Z0-9._-]{3,128}$
startsAt
string<date-time>
required

ISO-8601 inclusive start of the booked window.

endsAt
string<date-time>
required

ISO-8601 exclusive end of the booked window. Must be after startsAt, in the future, and at most 24h after startsAt.

deviceLabelSnapshot
string

Optional human-readable device label for the audit trail.

Maximum string length: 120
notes
string

Optional free-text note shown on the booking calendar.

Maximum string length: 500

Response

201 - application/json

The created desk reservation.

data
object

A hoteling desk reservation as returned to the booking calendar.