SKILL.md

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.