---
title: "Enable Workspace Sync"
method: POST
path: "/api/v1/workspaces/{workspace_id}/sync/enable"
tags: ["workspaces"]
---

# Enable Workspace Sync

`POST /api/v1/workspaces/{workspace_id}/sync/enable`

Enable sync for a workspace.

This endpoint is designed to be called from the web UI. It:
1. Sends an RPC request to the user's machine to enable sync
2. The machine daemon will upload the base ref bundle
3. The machine daemon will sync all worktree checkpoints
4. The machine daemon will update the workspace config to enable sync

Returns immediately after sending the RPC request. The actual sync
operation happens asynchronously on the machine.

Args:
    workspace_id: The workspace to enable sync for
    machine_id: Optional machine ID to target. If not provided, will use
               the first online machine that has this workspace.

## Path parameters

- `workspace_id` string, required

## Query parameters

- `machine_id` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/omnara/apis/omnara-api.md) · [All operations](https://skmtc.dev/omnara/apis/omnara-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/omnara/omnara-api/revisions/624048e40cad/schema)