Documentation Index Fetch the complete documentation index at: https://doc.rapida.ai/llms.txt
Use this file to discover all available pages before exploring further.
Configuration File Edit docker/integration-api/.integration.env before starting the service.
Required Variables Variable Default Description SECRETrpd_pksJWT signing secret — must be identical across all services POSTGRES__HOSTpostgresPostgreSQL host POSTGRES__DB_NAMEintegration_dbDatabase name POSTGRES__AUTH__USERrapida_userDatabase user POSTGRES__AUTH__PASSWORD— Database password REDIS__HOSTredisRedis host INTEGRATION_CRYPTO_KEY— AES-256-GCM encryption key for provider credentialsWEB_HOSTweb-api:9001web-api gRPC address
INTEGRATION_CRYPTO_KEY protects all stored provider credentials. If this key is rotated or lost, all stored credentials become unreadable and must be re-entered through the dashboard. Store it in a secret manager (AWS Secrets Manager, HashiCorp Vault, Kubernetes Secrets) — never commit it to version control.Generate a key: openssl rand -hex 32
Service Identity Variable Default Description SERVICE_NAMEintegration-apiInternal service label HOST0.0.0.0Bind address PORT9004HTTP / gRPC port LOG_LEVELdebugdebug · info · warn · errorENVdevelopmentdevelopment · staging · production
PostgreSQL Variable Default Description POSTGRES__HOSTpostgresHost (localhost for local dev) POSTGRES__PORT5432Port POSTGRES__DB_NAMEintegration_dbDatabase name POSTGRES__AUTH__USERrapida_userUser POSTGRES__AUTH__PASSWORDrapida_db_passwordPassword POSTGRES__MAX_OPEN_CONNECTION10Connection pool size POSTGRES__SSL_MODEdisabledisable · require · verify-full
Redis Variable Default Description REDIS__HOSTredisRedis host (localhost for local dev) REDIS__PORT6379Redis port
Optional OAuth Variables Used when provider OAuth flows are enabled (Google, GitHub):
Variable Description OAUTH_CALLBACK_URLOAuth redirect URI GOOGLE_OAUTH_CLIENT_IDGoogle OAuth app client ID GOOGLE_OAUTH_CLIENT_SECRETGoogle OAuth app client secret GITHUB_OAUTH_CLIENT_IDGitHub OAuth app client ID GITHUB_OAUTH_CLIENT_SECRETGitHub OAuth app client secret
Full Environment File # ── Service identity ────────────────────────────────────────────── SERVICE_NAME=integration-api HOST=0.0.0.0 PORT=9004 LOG_LEVEL=debug SECRET=rpd_pks ENV=development # ── PostgreSQL ──────────────────────────────────────────────────── POSTGRES__HOST=postgres POSTGRES__PORT=5432 POSTGRES__DB_NAME=integration_db POSTGRES__AUTH__USER=rapida_user POSTGRES__AUTH__PASSWORD=rapida_db_password POSTGRES__MAX_OPEN_CONNECTION=10 POSTGRES__SSL_MODE=disable # ── Redis ───────────────────────────────────────────────────────── REDIS__HOST=redis REDIS__PORT=6379 # ── Credential encryption ───────────────────────────────────────── # Generate: openssl rand -hex 32 INTEGRATION_CRYPTO_KEY=your_32_char_encryption_key_here # ── Internal service addresses ──────────────────────────────────── WEB_HOST=web-api:9001
Next Steps
Adding Providers How to implement the LargeLanguageCaller interface.
Overview Integration API purpose and credential encryption.
