{"openapi":"3.1.0","info":{"title":"getSichtbar Agentic Conversion API","version":"0.1.0","description":"Public API for AI-assisted action flows: service discovery, recommendations, slot suggestions, holds and confirmations."},"servers":[{"url":"https://www.getsichtbar.com"}],"externalDocs":{"description":"Human booking page and privacy policy","url":"https://www.getsichtbar.com/termin"},"paths":{"/api/agentic-booking/services":{"get":{"operationId":"listBookableServices","summary":"List bookable getSichtbar services","responses":{"200":{"description":"Bookable services"}}}},"/api/agentic-booking/recommend":{"post":{"operationId":"recommendBookingService","summary":"Recommend the right booking service for a user intent","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["intent"],"properties":{"intent":{"type":"string"},"domain":{"type":"string"}}}}}},"responses":{"200":{"description":"Recommended service"}}}},"/api/agentic-booking/slots":{"get":{"operationId":"getAvailableSlots","summary":"Get suggested slots for a service","parameters":[{"name":"service","in":"query","schema":{"type":"string"},"required":true},{"name":"timezone","in":"query","schema":{"type":"string"},"required":false}],"responses":{"200":{"description":"Slot suggestions"}}}},"/api/agentic-booking/holds":{"post":{"operationId":"createBookingHold","summary":"Create a temporary hold for a selected slot","description":"Creates a 15-minute hold after the user has selected a slot and supplied the service's required lead fields. Requires Bearer API key for GPT/connector calls or same-origin website context.","security":[{"AgenticBookingApiKey":[]}],"x-openai-isConsequential":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["serviceId","slotId","lead"],"properties":{"serviceId":{"type":"string"},"slotId":{"type":"string"},"idempotencyKey":{"type":"string"},"lead":{"type":"object","description":"Lead context. Required fields depend on the selected service; services expose requiredFields. For agentic-conversion and ai-commerce, include company, domain and context.","required":["name","email"],"properties":{"name":{"type":"string"},"email":{"type":"string","format":"email"},"company":{"type":"string"},"domain":{"type":"string"},"market":{"type":"string"},"context":{"type":"string"},"timezone":{"type":"string"},"sourceHost":{"type":"string"}}}}}}}},"responses":{"201":{"description":"Booking hold"}}}},"/api/agentic-booking/confirm":{"post":{"operationId":"confirmBooking","summary":"Confirm a booking hold after explicit user confirmation","description":"Only call this after the user explicitly confirms the chosen service, slot and email. If Google Calendar is configured, this creates a real calendar event and Google Meet link.","security":[{"AgenticBookingApiKey":[]}],"x-openai-isConsequential":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["holdId","userConfirmed"],"properties":{"holdId":{"type":"string"},"userConfirmed":{"type":"boolean","const":true}}}}}},"responses":{"200":{"description":"Booking confirmation"}}}}},"components":{"securitySchemes":{"AgenticBookingApiKey":{"type":"http","scheme":"bearer","description":"Bearer token configured via AGENTIC_BOOKING_API_KEY. Same-origin website requests are also accepted by the server."}}}}