resources

Queue a resource booking

Clerk session or agt_ token with resources:book. Queues a booking envelope (returns queued, not confirmed). IDEMPOTENT: a repeat within 30 days for the exact same start time is recognized (was_dup: true); an Idempotency-Key additionally replays the first result. Agent callers MUST supply email.

post/api/resources/book

Request

  • Base URL: https://www.immersivecommons.com
  • URL: https://www.immersivecommons.com/api/resources/book
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional. A retry carrying the same key replays the first successful result verbatim instead of creating a second side effect (honored by lib/idempotency.ts, 24h window). Complementary to each endpoint's own semantic dedupe. Absent = no replay.

Request body

resource_idstring required

e.g. "ft-9" or "printer-prusa-1".

start_isostring date-time required
end_isostring date-time required

After start.

purposestring

Free text, trimmed + clipped to 600 chars server-side.

emailstring

Required for agent callers; optional on the Clerk path.

Response

Booking queued (or recognized as a duplicate).

okboolean required
queuedboolean required
was_dupboolean

True when semantic dedupe recognized this as a repeat within the window.

via'clerk' | 'agent'
notestring

Changes

No recorded changes to this operation across all 1 revision of this API.