Integration API

Configuration File

Edit docker/integration-api/.integration.env before starting the service.

Required Variables

Variable	Default	Description
`SECRET`	`rpd_pks`	JWT signing secret — must be identical across all services
`POSTGRES__HOST`	`postgres`	PostgreSQL host
`POSTGRES__DB_NAME`	`integration_db`	Database name
`POSTGRES__AUTH__USER`	`rapida_user`	Database user
`POSTGRES__AUTH__PASSWORD`	—	Database password
`REDIS__HOST`	`redis`	Redis host
`INTEGRATION_CRYPTO_KEY`	—	AES-256-GCM encryption key for provider credentials
`WEB_HOST`	`web-api:9001`	web-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_NAME`	`integration-api`	Internal service label
`HOST`	`0.0.0.0`	Bind address
`PORT`	`9004`	HTTP / gRPC port
`LOG_LEVEL`	`debug`	`debug` · `info` · `warn` · `error`
`ENV`	`development`	`development` · `staging` · `production`

PostgreSQL

Variable	Default	Description
`POSTGRES__HOST`	`postgres`	Host (`localhost` for local dev)
`POSTGRES__PORT`	`5432`	Port
`POSTGRES__DB_NAME`	`integration_db`	Database name
`POSTGRES__AUTH__USER`	`rapida_user`	User
`POSTGRES__AUTH__PASSWORD`	`rapida_db_password`	Password
`POSTGRES__MAX_OPEN_CONNECTION`	`10`	Connection pool size
`POSTGRES__SSL_MODE`	`disable`	`disable` · `require` · `verify-full`

Redis

Variable	Default	Description
`REDIS__HOST`	`redis`	Redis host (`localhost` for local dev)
`REDIS__PORT`	`6379`	Redis port

Optional OAuth Variables

Used when provider OAuth flows are enabled (Google, GitHub):

Variable	Description
`OAUTH_CALLBACK_URL`	OAuth redirect URI
`GOOGLE_OAUTH_CLIENT_ID`	Google OAuth app client ID
`GOOGLE_OAUTH_CLIENT_SECRET`	Google OAuth app client secret
`GITHUB_OAUTH_CLIENT_ID`	GitHub OAuth app client ID
`GITHUB_OAUTH_CLIENT_SECRET`	GitHub 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

Getting Started

Dashboard (UI)

Web API

Assistant API

Endpoint API

Document API

Integration API — Configuration

Configuration File

Required Variables

Service Identity

PostgreSQL

Redis

Optional OAuth Variables

Full Environment File

Next Steps

Adding Providers

Overview

​Configuration File

​Required Variables

​Service Identity

​PostgreSQL

​Redis

​Optional OAuth Variables

​Full Environment File

​Next Steps

Adding Providers

Overview

Configuration File

Required Variables

Service Identity

PostgreSQL

Redis

Optional OAuth Variables

Full Environment File

Next Steps