---
title: "Update Checkpoint Sync Status"
method: PATCH
path: "/api/v1/workspaces/{workspace_id}/sync/checkpoint-status"
tags: ["workspaces"]
---

# Update Checkpoint Sync Status

`PATCH /api/v1/workspaces/{workspace_id}/sync/checkpoint-status`

Update checkpoint sync status on the worktree.

Called by the daemon after successfully uploading a checkpoint.

Updates:
1. Sets last_synced_checkpoint_id on the worktree that owns this checkpoint
2. Always updates workspace sync_state.synced_checkpoints

Worktree lookup strategy:
1. First try matching current_checkpoint_id (fast path for quick syncs)
2. If not found (race condition: user created new checkpoint during sync),
   fall back to the single worktree if only one exists

The last_synced_checkpoint_id field tracks the last successfully synced
checkpoint. This may differ from current_checkpoint_id if:
- The user created new checkpoints while sync was in progress
- A sync upload failed for a more recent checkpoint

This allows us to always have a known-good checkpoint to fall back to.

## Path parameters

- `workspace_id` string, required

## Request body

- CheckpointSyncStatusUpdateRequest — Request to update checkpoint sync status on a worktree.
  - `checkpoint_id` string, required
  - `synced` boolean, required

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