---
name: omni-sync-cloud
description: Synchronise OmniRoute configuration, provider connections, and settings to/from cloud storage. Manage cloud worker authentication and remote backup targets.
---
<!-- 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 https://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 https://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 https://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 https://localhost:20128/api/cloud/models/alias \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
```

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

Update cloud model alias

```bash
curl -X PUT https://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 https://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 https://localhost:20128/api/sync/initialize \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
  -H "Content-Type: application/json" \
  -d '{}'
```

## Payloads

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