# bookinglinks > bookinglinks is a scheduling service. A host shares a booking link (/b/); anyone, people or bots, > can list its open times and book a meeting without an account. Hosts manage their links with an API token. Base URL: https://alphacentauritech.com/bookinglinks/ OpenAPI 3 spec: https://alphacentauritech.com/bookinglinks/api/openapi.json All times are ISO 8601. Send and expect JSON (Content-Type: application/json). No cookies, CSRF tokens or JavaScript are needed for the API. Errors are {"error": "", "message": ""}; HTTP 429 comes with a Retry-After header (seconds). Be polite: about 1 request per second is plenty. Network: reuse one connection (keep-alive) for several requests, use a connect timeout of about 3 s and retry a dropped connection up to 3 times. A 403 with the header x-rasp-block: 1 is the host's firewall and usually temporary: wait 30 to 60 s, then retry once or twice. Never retry fast in a loop. Any other 403 is final. Terms: Booking through this API means you agree to the Terms of Service (https://alphacentauritech.com/bookinglinks/terms) and acknowledge the Privacy Policy (https://alphacentauritech.com/bookinglinks/privacy). Every booking request must send "agree_to_terms": true (see step 4). ## Book a meeting (no account) 1. Find the link. A booking URL looks like https://alphacentauritech.com/bookinglinks/b/. The page carries JSON-LD and a pointing at the link's JSON. 2. Read the link: GET https://alphacentauritech.com/bookinglinks/api/public/links/ -> title, durations (minutes), locations (meet = Google Meet video, phone = the host calls the booker's number, in_person = at the address given, phone_host = the booker calls the "phone" number shown, custom = a meeting link the host already has, such as Zoom). The custom address itself is not in this response. host_timezone, slots_url, book_url. 3. List open times: GET https://alphacentauritech.com/bookinglinks/api/public/links//slots?from=2026-11-02&to=2026-11-08&tz=America/Los_Angeles&duration=30 from/to are dates in tz (to inclusive, at most 62 days); omit them for the whole booking window. -> {"slots": [{"start_utc", "start_local", "end_utc", "tz_abbr", "repeated"}], ...} 4. Book: POST https://alphacentauritech.com/bookinglinks/api/public/links//book Content-Type: application/json {"start": "", "duration": 30, "tz": "America/Los_Angeles", "name": "Ada Lovelace", "email": "ada@example.com", "location": "meet", "phone": "+1 555 0100", "note": "optional", "agree_to_terms": true} - location is required when the link offers more than one kind; phone is required for location "phone". - Use the booker's real name and email: the confirmation and calendar invite go to that email. - agree_to_terms: true is required (the booker agrees to the Terms and acknowledges the Privacy Policy); without it: 422 terms_not_accepted. -> 201 {"id", "start", "end", "status": "confirmed", "meet_url", "meeting_url", "manage_url", "api": {"booking", "reschedule_slots", "reschedule", "cancel"}} meet_url is set for Google Meet. meeting_url is the host's link when location is custom (the query string is kept); it is null otherwise. custom does not create a Google Meet. 409 slot_taken or 422 slot_unavailable: list slots again and pick another time. 5. Keep the returned URLs; they contain a secret manage token (treat it like a password). - Look up: GET api.booking - Reschedule: GET api.reschedule_slots (same query as slots), then POST api.reschedule {"start": "...", "tz": "..."} - Cancel: POST api.cancel with body {} (Content-Type: application/json) People can use the manage_url page instead. Limits: 10 booking, reschedule or failed attempts per 10 minutes per IP address. Only the times listed by the slots endpoint can be booked. A link takes API bookings only if its host allows them ("api_booking": true in step 2; otherwise 403 api_booking_disabled), and at most "api_daily_cap" API bookings per UTC day (then 429 api_daily_cap_reached with Retry-After). People can always book on the booking page. No JavaScript? https://alphacentauritech.com/bookinglinks/b//times shows a week of times as a plain HTML form. ## Host API (for a host's own bots) A signed-in host creates a token in Admin > API tokens (https://alphacentauritech.com/bookinglinks/admin/api-tokens): a name, read or read+write, optional expiry. The token (blk_...) is shown once. Send it as "Authorization: Bearer " or, when the site is behind HTTP Basic Auth (staging), as "X-API-Key: ". Session cookies are never accepted on /api/v1. Limits: 300 requests per 10 minutes per token. Writes are recorded in an audit log. - GET https://alphacentauritech.com/bookinglinks/api/v1/me who the token acts for, its scopes, the host's time zone - GET https://alphacentauritech.com/bookinglinks/api/v1/calendars calendar ids (for dest_calendar_id and calendar_overrides) - GET https://alphacentauritech.com/bookinglinks/api/v1/links all links - POST https://alphacentauritech.com/bookinglinks/api/v1/links create (write scope) - GET https://alphacentauritech.com/bookinglinks/api/v1/links/ one link - PATCH https://alphacentauritech.com/bookinglinks/api/v1/links/ change only the fields sent (POST to the same URL also works) - POST https://alphacentauritech.com/bookinglinks/api/v1/links//deactivate stop taking bookings (or /activate) - DELETE https://alphacentauritech.com/bookinglinks/api/v1/links/ delete a link with no bookings (or POST .../delete) - GET https://alphacentauritech.com/bookinglinks/api/v1/bookings?from=2026-11-01&to=2026-12-01&status=confirmed (status: all, confirmed, pending, cancelled, ...) - POST https://alphacentauritech.com/bookinglinks/api/v1/bookings//cancel cancel a booking (the booker's invite is cancelled) Link fields (JSON): title, slug (lowercase letters, digits, hyphens), description, active (bool), durations ([15], [30], [60] or several of 15/30/60), locations (["meet"], ["phone"], ["in_person"], ["phone_host"], ["custom"] or several; in_person needs "address"; custom needs "url" or meeting_url, one https link with no username or password in it; phone_host needs your account phone set on the Availability page), weekly_hours ({"mon": "09:00-12:00, 13:00-17:00", "tue": [["09:00","17:00"]]}; null = the host's global hours), date_overrides (["2026-11-26 off", "2026-11-24 off 12:00-13:00", "2026-11-28 10:00-14:00"]), min_notice_min, horizon_days, buffer_before_min, buffer_after_min, increment_min, max_per_day (number, or null for the host's default), dest_calendar_id (null = default calendar), calendar_overrides ([{"calendar_id": 3, "busy": "include"|"exclude"|null, "dest": "schedule_on"|"avoid"|null}]). Times are in the host's time zone. duration_mode / location_mode ("fixed" or "choice") follow from the lists. Example: create a 60-minute in-person link, Mon-Fri afternoons POST https://alphacentauritech.com/bookinglinks/api/v1/links {"title": "Parent meeting", "slug": "parent-meeting", "durations": [60], "locations": [{"kind": "in_person", "address": "123 School St"}], "weekly_hours": {"mon": "14:30-16:30", "tue": "14:15-16:30"}, "min_notice_min": 1440} ## Error codes - not_found: No such booking link, booking or resource (or it is no longer active). - method_not_allowed: That HTTP method is not supported on this path. - invalid_tz: tz must be an IANA time zone name, e.g. America/Los_Angeles. - invalid_range: from/to must be YYYY-MM-DD dates, to on or after from, at most 62 days apart. - invalid_duration: duration must be one of the link's durations (minutes); see "durations" or "allowed". - terms_not_accepted: Booking through this API means you agree to the Terms of Service and acknowledge the Privacy Policy. Send "agree_to_terms": true in the body; see /terms and /privacy. - api_booking_disabled: This booking link does not take bookings through the API. Book on the booking page instead (booking_page_url), or ask the host to turn on "Allow bookings through the API". - api_daily_cap_reached: This booking link has taken its maximum number of API bookings for today (UTC). Try again after the number of seconds in Retry-After, or book on the booking page. - invalid_input: name, email and tz are required; name max 255 characters, note max 2000. - invalid_start: start must be an ISO 8601 time with offset on a 5-minute step, e.g. 2026-11-03T09:00:00-08:00 (use a slot's start_local). - invalid_location: location must be one of the link's location kinds; required when the link offers more than one. - invalid_phone: phone is required for a phone booking: 7-32 digits, spaces, +, (, ), . or -. - invalid_destination: The host has no calendar that can hold bookings for this link. - slot_unavailable: That time is not offered (anymore). List slots again and pick another. - slot_taken: Someone else just booked that time. List slots again and pick another. - no_destination: This link cannot take bookings right now (the host has no calendar set up for it). - calendar_unavailable: The host's calendar could not be reached. Try again in a minute. - rate_limited: Too many requests. Wait the number of seconds in the Retry-After header, then retry. - unsupported_media_type: Send the body as JSON with the header Content-Type: application/json. - invalid_json: The body is not a JSON object. - unauthorized: Send a valid API token: "Authorization: Bearer " or "X-API-Key: ". Tokens are made in Admin > API tokens. - insufficient_scope: This token is read-only. Create a token with the write scope for this request. - validation_failed: Some fields are invalid; see "fields" for each problem. - slug_taken: That slug is already in use by another link. - has_bookings: This link has bookings, so it cannot be deleted. Deactivate it instead. - invalid_csrf: The page expired. Reload the booking page and try again (bots: use the JSON API, which needs no token). - server_error: Something went wrong on our side. Try again later. ## Humans Host sign-in: https://alphacentauritech.com/bookinglinks/admin/login (email + 6-digit code; also on the homepage https://alphacentauritech.com/bookinglinks/). Privacy: https://alphacentauritech.com/bookinglinks/privacy