Overview
Synchronise OmniRoute 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 OmniRoute cloud worker for remote access.
curl -X POST http://localhost:20128/api/cloud/auth \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
PUT /api/cloud/credentials/update
Update cloud worker credentials
curl -X PUT http://localhost:20128/api/cloud/credentials/update \
-H "Authorization: Bearer $OMNIROUTE_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 http://localhost:20128/api/cloud/model/resolve \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
GET /api/cloud/models/alias
Get cloud model aliases
curl http://localhost:20128/api/cloud/models/alias \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
PUT /api/cloud/models/alias
Update cloud model alias
curl -X PUT http://localhost:20128/api/cloud/models/alias \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
POST /api/sync/cloud
Sync with cloud
curl -X POST http://localhost:20128/api/sync/cloud \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
POST /api/sync/initialize
Initialize cloud sync
curl -X POST http://localhost:20128/api/sync/initialize \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
GET /api/sync/bundle
GET sync › bundle
curl http://localhost:20128/api/sync/bundle \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/sync/tokens
GET sync › tokens
curl http://localhost:20128/api/sync/tokens \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/sync/tokens
POST sync › tokens
curl -X POST http://localhost:20128/api/sync/tokens \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
DELETE /api/sync/tokens/{id}
DELETE sync › tokens ›
curl -X DELETE http://localhost:20128/api/sync/tokens/{id} \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
Payloads
See the full OpenAPI specification at GET /api/openapi/spec or docs/openapi.yaml for detailed request/response schemas.