# Travila Platform

> Multi-tenant backend platform for conversational AI applications. Handles text interactions (voice in progress), file storage, multi-channel notifications, scheduled jobs, and third-party integrations — with per-tenant isolation and durable execution via Restate.

All API contracts are defined in Protocol Buffers. Every endpoint follows the pattern: `POST /api/v1/<domain>/<service>/<method>` with a JSON body.

## Getting Started

- [Platform Overview](https://docs.yocaso.dev/docs): Introduction, domain map, and guide index
- [Quickstart](https://docs.yocaso.dev/docs/getting-started/quickstart): Make your first API call in under a minute
- [Authentication](https://docs.yocaso.dev/docs/getting-started/authentication): JWT, API keys, and publishable keys

## Guides

- [Conversations](https://docs.yocaso.dev/docs/guides/conversations): Multi-turn threads, streaming responses, generation config, and tool calling
- [Model Routing](https://docs.yocaso.dev/docs/guides/model-routing): Pre-filter candidate models by capability, cost, and modality before generation
- [MCP Tools](https://docs.yocaso.dev/docs/guides/mcp-tools): Discover and call MCP tools, manage approval workflows
- [Memory](https://docs.yocaso.dev/docs/guides/memory): Semantic memory search, CRUD, and conversation integration via Mem0
- [Storage](https://docs.yocaso.dev/docs/guides/storage): File upload/download, folders, metadata, pre-signed URLs, and quota
- [Notifications](https://docs.yocaso.dev/docs/guides/notifications): Push (FCM), in-app, email, SMS, and chat via Novu — topics, digest, workflows
- [Scheduled Jobs](https://docs.yocaso.dev/docs/guides/scheduled-jobs): Cron, one-shot, and recurring-interval jobs with retry and auto-pause
- [API Keys](https://docs.yocaso.dev/docs/api-keys/customer-guide): Secret and publishable keys, scopes, rate limiting, and rotation

## Advanced

- [Architecture](https://docs.yocaso.dev/docs/architecture): Request flow, component types (gateways, actors, services, workflows), infrastructure, and deployment
- [Multi-Tenancy](https://docs.yocaso.dev/docs/getting-started/multi-tenancy): Firebase Identity Platform, tenant isolation, and client app setup

## API Reference

- [LLM Gateway API](https://docs.yocaso.dev/docs/api/llm-gateway/llm-gateway-api): 25 RPCs — conversations, threads, messages, generation, streaming, MCP tool execution
- [Storage Gateway API](https://docs.yocaso.dev/docs/api/storage-gateway/storage-gateway-api): 13 RPCs — file upload/download, folders, metadata, pre-signed URLs, quota
- [Auth Gateway API](https://docs.yocaso.dev/docs/api/auth-gateway/auth-gateway-api-api-key-management): 7 RPCs — API key create, get, update, list, rotate, revoke, and usage
- [Notification Gateway API](https://docs.yocaso.dev/docs/api/notification-gateway/notification-gateway-api): 42 RPCs — subscribers, topics, triggers, workflows, providers, delivery status
- [Scheduler Gateway API](https://docs.yocaso.dev/docs/api/scheduler-gateway/scheduler-gateway-api): 10 RPCs — create, get, list, update, pause, resume, and delete jobs (individually, per-project, and per-owner), plus list executions