{"openapi":"3.1.0","info":{"title":"Cicero Public Booking API","version":"1.0.0","description":"Find and book a free Cicero Learning consultation. No authentication required. Two steps: list availability, then book a returned slot. An MCP endpoint wrapping the same tools is available at https://admin.cicerolearning.com/api/public/booking/mcp."},"servers":[{"url":"https://admin.cicerolearning.com/api/public/booking"}],"paths":{"/availability":{"post":{"operationId":"listAvailability","summary":"List bookable slots for an event type","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvailabilityRequest"}}}},"responses":{"200":{"description":"Open slots in the resolved window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvailabilityResult"}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"}}}},"/book":{"post":{"operationId":"bookConsult","summary":"Create a booking for a specific slot","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookRequest"}}}},"responses":{"200":{"description":"Booking confirmed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookResult"}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"description":"The slot is no longer available; fetch availability again.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"responses":{"Error":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"AvailabilityRequest":{"type":"object","required":["eventTypeSlug"],"properties":{"eventTypeSlug":{"type":"string","examples":["cicero-consult"]},"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"},"days":{"type":"integer","minimum":1,"maximum":62}},"additionalProperties":false},"AvailabilityResult":{"type":"object","properties":{"eventType":{"type":"object","properties":{"name":{"type":"string"},"durationMinutes":{"type":"integer"},"location":{"type":["string","null"]}}},"range":{"type":"object","properties":{"fromIso":{"type":"string","format":"date-time"},"toIso":{"type":"string","format":"date-time"}}},"slots":{"type":"array","items":{"$ref":"#/components/schemas/Slot"}}}},"Slot":{"type":"object","properties":{"startIso":{"type":"string","format":"date-time"},"endIso":{"type":"string","format":"date-time"}}},"BookRequest":{"type":"object","required":["eventTypeSlug","startIso","endIso","customerName","customerEmail","customerTimezone","note"],"properties":{"eventTypeSlug":{"type":"string","examples":["cicero-consult"]},"startIso":{"type":"string","format":"date-time"},"endIso":{"type":"string","format":"date-time"},"customerName":{"type":"string"},"customerEmail":{"type":"string","format":"email"},"customerTimezone":{"type":"string","examples":["America/New_York"]},"note":{"type":"string"},"customerPhone":{"type":"string","examples":["+14155550123"]},"source":{"type":"string","description":"Attribution marker; defaults to \"api\"."}},"additionalProperties":false},"BookResult":{"type":"object","properties":{"id":{"type":"string"},"startIso":{"type":"string","format":"date-time"},"endIso":{"type":"string","format":"date-time"},"manageUrl":{"type":"string","format":"uri"},"meetLink":{"type":["string","null"],"format":"uri"}}},"Error":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}