Galadri API Documentation

One API for automotive AI. Tools, data, communications, and rich results built in.

Galadri is a complete backend for automotive AI applications. You get a streaming chat endpoint backed by an AI agent that connects to 20+ real-world data sources, automatically manages per-user data, communicates across channels, and returns structured results your UI can render as maps and cards. One integration replaces months of work.

Guides

Tools, Skills, and Hooks

Capabilities and runtime automation

Your agent connects to NHTSA, Google Maps, TomTom, HERE, MarketCheck, repair booking, and more through the chat endpoint. Galadri handles upstream auth, rate limits, error handling, and response normalization. You can also add custom HTTP or MCP capabilities, on-demand skills, and runtime hooks that run custom capabilities at the start or end of each message.

Communications

Multi-channel, bidirectional

Send emails with ICS calendar invites, text messages, and phone calls. The agent handles booking confirmations, maintenance reminders, and proactive alerts. Bring your own SendGrid and Twilio transport, and Galadri manages the AI voice layer for calls.

Rich Results

Maps, cards, and interactive UI

Tool results return structured data with stable IDs, coordinates, photos, and URLs. Your client renders maps, vehicle cards, station cards, and shop listings. The AI receives compact summaries to stay context-efficient while your UI gets the full picture. Display capabilities let the agent adapt its text to match what your frontend supports.

API Reference

Chat API

/v1/chat

The main conversational endpoint. Send a message to an agent and let Galadri decide when to use capabilities, managed data, and communications.

Communications API

/v1/emails, /v1/sms, /v1/calls

Send emails, texts, and phone calls directly without going through chat. Useful for server-side orchestration and provider-triggered workflows.

Data Model

Schemas and objects

Reference the managed entities Galadri stores for each end user, including vehicles, documents, milestones, schedules, and execution logs.

New to Galadri?

Start with the Quickstart guide to make your first API call in under 2 minutes.

Quick example

curl

curl -X POST https://api.galadri.com/v1/chat \
  -H "Authorization: Bearer gld_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "my-agent",
    "message": "Find oil change shops near Phoenix, AZ",
    "end_user_id": "user-123"
  }'

Base URL

https://api.galadri.com

All API endpoints are served from this base URL. Authentication is via API key in the Authorization header. See Authentication for details.

QuickstartNext