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

20+ real-world data sources

Your agent connects to NHTSA, Google Maps, TomTom, HERE, MarketCheck, repair booking, and more through a single endpoint. Independent actions execute in parallel via the meta-tool pattern. Each tool handles upstream auth, rate limits, error handling, and response normalization. You can also add custom tools via HTTP webhooks or MCP.

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 tools, managed data, and communications.

Tool Execution API

/v1/tools/execute

Run one or more tool actions directly over HTTP when your backend, webhook, or job runner already knows which tools it wants to execute.

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