# Travila Platform

> Multi-tenant backend platform for conversational AI applications. Handles text interactions (voice in progress), file storage, multi-channel notifications, scheduled jobs, end-user profiles, and outbound webhooks — with per-tenant isolation and durable execution.

All API contracts are defined in Protocol Buffers. Every endpoint is a `POST` with a JSON body, following the pattern `POST /api/v1/<domain>/<service>/<method>`, encoded as protojson.

## Getting Started

- [Platform Overview](https://docs.travila.ai/docs): Introduction, domain map, and guide index
- [Quickstart](https://docs.travila.ai/docs/getting-started/quickstart): Make your first API call in under a minute
- [Authentication & API Keys](https://docs.travila.ai/docs/api-keys/customer-guide): Secret keys for backends, publishable key + user JWT for client apps; scopes, rotation, code examples

## Guides

- [Conversations](https://docs.travila.ai/docs/guides/conversations): Multi-turn threads, streaming responses, generation config, and tool calling
- [Agent Profiles](https://docs.travila.ai/docs/guides/conversations/configuration#agent-profiles): Reusable, versioned agent config (prompt, model, tools) applied per thread or per turn
- [Model Routing](https://docs.travila.ai/docs/guides/model-routing): Pre-filter candidate models by capability, cost, and modality before generation
- [MCP Tools](https://docs.travila.ai/docs/guides/mcp-tools): Discover and call MCP tools, manage approval workflows
- [Memory](https://docs.travila.ai/docs/guides/memory): Semantic memory search, CRUD, and conversation integration via Mem0
- [Storage](https://docs.travila.ai/docs/guides/storage): File upload/download, folders, metadata, pre-signed URLs, and quota
- [Notifications](https://docs.travila.ai/docs/guides/notifications): Push (FCM), in-app, email, SMS, and chat via Novu — topics, digest, workflows
- [Scheduled Jobs](https://docs.travila.ai/docs/guides/scheduled-jobs): Cron, one-shot, and recurring-interval jobs with retry and auto-pause
- [Webhooks](https://docs.travila.ai/docs/guides/webhooks): Outbound webhooks — endpoints, subscriptions, event types, delivery history and retries
- [Streaming](https://docs.travila.ai/docs/guides/streaming) (coming soon, not enabled yet): Live token-by-token delivery over Firebase
- [API Keys](https://docs.travila.ai/docs/api-keys/customer-guide): Secret and publishable keys, scopes, and rotation

## Examples

- [Mobile App](https://docs.travila.ai/docs/examples/mobile-app): Worked end-to-end client integration — auth, a chat turn, files, and push

## API Reference

- [API Overview](https://docs.travila.ai/docs/api): Base URL, request format, authentication headers, and the full service index
- [LLM APIs](https://docs.travila.ai/docs/api/llm-gateway/llm-apis): 31 RPCs — threads, messages, message feedback, generation, MCP tool execution, memories
- [Storage APIs](https://docs.travila.ai/docs/api/storage-gateway/storage-apis): 15 RPCs — file upload/download, folders, metadata, pre-signed URLs, quota
- [End User APIs](https://docs.travila.ai/docs/api/enduser-gateway/end-user-apis): 5 RPCs — end-user profile self-service: location, locale, default generation config, metadata
- [Notification APIs](https://docs.travila.ai/docs/api/notification-gateway/notification-apis): 46 RPCs — subscribers, topics, triggers, workflows, providers, delivery status
- [Scheduler APIs](https://docs.travila.ai/docs/api/scheduler-gateway/scheduler-apis): 10 RPCs — create, get, list, update, pause, resume, and delete jobs (individually, per-project, and per-owner), plus list executions
- [Webhook APIs](https://docs.travila.ai/docs/api/webhook-gateway/webhook-apis): 9 RPCs — webhook endpoints, subscriptions, delivery history, and retries
- [Agent Profile APIs](https://docs.travila.ai/docs/api/agent-profile-gateway/agent-profile-apis): 14 RPCs — agent profiles (create, version, delete), shared prompt fragments, prompt-library import

Total: 130 RPCs across 7 services.

## Tooling

- [Postman Collection](https://docs.travila.ai/postman/travila-platform.postman_collection.json): All 122 endpoints, one folder per API, generated from the OpenAPI specs
- [Postman Environment](https://docs.travila.ai/postman/travila-platform.postman_environment.json): baseUrl, apiKey, jwt, onBehalfOf