omni-sync-cloud

Overview

Synchronise AIRoute configuration, provider connections, and settings to/from cloud storage. Manage cloud worker authentication and remote backup targets.

Authentication

All requests require a valid Bearer token or session cookie. Obtain a token via POST /api/auth/login or configure REQUIRE_API_KEY=false for local development.

Endpoints

POST /api/cloud/auth

Authenticate with cloud worker

Authenticates with the AIRoute cloud worker for remote access.

curl -X POST https://localhost:20128/api/cloud/auth \
  -H "Authorization: Bearer $AIRoute_TOKEN"
  -H "Content-Type: application/json" \
  -d '{}'

PUT /api/cloud/credentials/update

Update cloud worker credentials

curl -X PUT https://localhost:20128/api/cloud/credentials/update \
  -H "Authorization: Bearer $AIRoute_TOKEN"
  -H "Content-Type: application/json" \
  -d '{}'

POST /api/cloud/model/resolve

Resolve model via cloud

Resolves a model request through the cloud worker.

curl -X POST https://localhost:20128/api/cloud/model/resolve \
  -H "Authorization: Bearer $AIRoute_TOKEN"
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/cloud/models/alias

Get cloud model aliases

curl https://localhost:20128/api/cloud/models/alias \
  -H "Authorization: Bearer $AIRoute_TOKEN"

PUT /api/cloud/models/alias

Update cloud model alias

curl -X PUT https://localhost:20128/api/cloud/models/alias \
  -H "Authorization: Bearer $AIRoute_TOKEN"
  -H "Content-Type: application/json" \
  -d '{}'

POST /api/sync/cloud

Sync with cloud

curl -X POST https://localhost:20128/api/sync/cloud \
  -H "Authorization: Bearer $AIRoute_TOKEN"
  -H "Content-Type: application/json" \
  -d '{}'

POST /api/sync/initialize

Initialize cloud sync

curl -X POST https://localhost:20128/api/sync/initialize \
  -H "Authorization: Bearer $AIRoute_TOKEN"
  -H "Content-Type: application/json" \
  -d '{}'

Payloads

See the full OpenAPI specification at GET /api/openapi/spec or docs/openapi.yaml for detailed request/response schemas.