AI Concierge

The VanityPass AI Concierge gives your end users a conversational travel assistant. It answers complex travel questions, recommends destinations and perks, and helps users make booking decisions — all streamed live inside your white-label app.

Concierge responses are delivered over Server-Sent Events (SSE), so tokens arrive progressively and you can render the reply as it is generated.

Key Endpoints

• Chat — Stream a conversational reply to a user's question.
• Conversation stream — Lower-level AI engine streaming with an explicit session.
• Conversation history — Replay a prior session's messages.
• Individual perk — Personalized perk recommendation for a room booking.
• Circle context — Concierge context for a group (circle) booking.
• Health checks — Verify the concierge SSE service and AI engine are available.

Capabilities

• Answer travel questions (visa requirements, packing tips, local tips).
• Recommend destinations, hotels, and experiences based on the user's context.
• Explain booking options and suggest the best perk for a booking.
• Handle multi-turn conversations tied to a session_id.
• Provide localized, context-aware responses streamed token-by-token.

Authentication

Every concierge request uses white-label (JWT) auth. Send:

• Authorization: Bearer <JWT> — Issued by your OAuth2 provider.
• X-App-Id: <uuid> (or X-App-Slug: <slug>) — Identifies your white-label app.
• X-Environment: Sandbox | Production — Routes to the correct environment.

Streaming overview

The chat and conversation endpoints respond with Content-Type: text/event-stream rather than a single JSON body. Read the connection as a stream and parse each event: / data: frame as it arrives. See AI Concierge Chat for the full stream format.

Concierge service health

GET /v1/concierge/health

Checks that the concierge SSE service is available. Returns 200 when healthy.

curl -X GET 'https://cloud.vanitypass.com/v1/concierge/health' \
  -H 'Content-Type: application/json' \
  -H 'X-Environment: Sandbox' \

AI engine health

GET /v1/engine/health

Checks the underlying AI engine's status. Returns 200 when the engine is healthy.

curl -X GET 'https://cloud.vanitypass.com/v1/engine/health' \
  -H 'Content-Type: application/json' \
  -H 'X-Environment: Sandbox' \