Omni Sync Cloud

---
name: omni-sync-cloud
description: Synchronise OmniRoute configuration, provider connections, and settings to/from cloud storage. Manage cloud worker authentication and remote backup targets.
---

> **This skill needs OmniRoute, which is installed separately.** From this skill's folder, run `python3 scripts/sfp_app.py status` to see whether it is installed and running. If it is not, run `python3 scripts/sfp_app.py install` to get the plan (it changes nothing), tell the user what it will do, and run it again with `--yes` only after they agree. `start` runs it when it is installed but stopped.
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

## 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.

```bash
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

```bash
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.

```bash
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

```bash
curl http://localhost:20128/api/cloud/models/alias \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
```

### PUT /api/cloud/models/alias

Update cloud model alias

```bash
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

```bash
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

```bash
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

```bash
curl http://localhost:20128/api/sync/bundle \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
```

### GET /api/sync/tokens

GET sync › tokens

```bash
curl http://localhost:20128/api/sync/tokens \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
```

### POST /api/sync/tokens

POST sync › tokens

```bash
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 › <id>

```bash
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.