Sign in
Booking Codes

Revoke a booking code

Changed on

Revoke a booking code by its opaque id. Org admins may revoke any booking code in the organization; other members may revoke only a code scoped to a calendar they own or an appointment type they participate in -- the same owner-or-org-admin rule POST applies at mint time. Non-oracle: revoking an already-revoked code, an id that does not exist within the caller's organization (including an id belonging to another organization or to a non-booking-code token), and an id the caller is not authorized to revoke, all return 204 without error and without touching the row -- a caller cannot distinguish 'does not exist' from 'not yours' from 'already revoked'.

delete/booking-codes/{id}{format}

Request

  • The document declares no server URL.
  • Auth: one of:
    • HTTP bearer
    • API key in cookie sessionid

Path parameters

format'.json' required
idstring required

Headers

X-Organization-Idstring

Selects the active organization for this request. Optional for callers that belong to exactly one active organization — the single membership is resolved implicitly. Required when the caller has two or more active memberships; omitting it in that case returns 400. If the header names an organization the caller is not an active member of, the server returns 403.

Response

No response body

Changes