Skip to main content
POST
Queue a resource booking

Authorizations

Authorization
string
header
required

Per-member, individually-revocable agent token minted via the device-code flow. Send as Authorization: Bearer agt_.... The scope array in each operation's security requirement names the IC scope the handler enforces.

Headers

Idempotency-Key
string

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.

Maximum string length: 255

Body

application/json
resource_id
string
required

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

start_iso
string<date-time>
required
end_iso
string<date-time>
required

After start.

purpose
string

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

email
string

Required for agent callers; optional on the Clerk path.

Response

Booking queued (or recognized as a duplicate).

Shared shape for the queue-and-forget writes (rsvp, book).

ok
boolean
required
queued
boolean
required
was_dup
boolean

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

rate
object

Per-token rate-limit snapshot returned by write endpoints.

via
enum<string>
Available options:
clerk,
agent
note
string