---
title: "Inspect sync cursor progress, freshness, health, and recent failures."
method: GET
path: "/api/sync/status"
---

# Inspect sync cursor progress, freshness, health, and recent failures.

`GET /api/sync/status`

## Request

- Base URL: `https://git.top`
- URL: `https://git.top/api/sync/status`
- Auth: none declared

## Query parameters

- `detail` string

## Response `200`

Sync status

- SyncStatusResponse
  - `detail` 'summary' | 'full', required
  - `health` string, required
  - `freshness` string, required
  - `cursor` object
  - `latest_success` object
  - `recent_failures` object[]
  - `priority` object, required
    - `policy` object, required
      - `hot_target_days` integer
      - `warm_target_days` integer
      - `cold_target_days` integer
    - `counts` object, required
    - `refresh_due_counts` object, required
    - `stale_counts` object, required
    - `stale_rates` object, required
    - `freshness_slo` SyncFreshnessSlo, required
      - `hot_projects` object, required
        - `total` integer, required
        - `within_target` integer, required
        - `freshness_rate` number, required
        - `target_rate` number, required
        - `meets_target` boolean, required
        - `target_hours` integer, required
      - `whole_corpus` object, required
        - `total` integer, required
        - `within_target` integer, required
        - `freshness_rate` number, required
        - `target_rate` number, required
        - `meets_target` boolean, required
        - `target_basis` 'tier_policy', required
    - `capacity` object, required
      - `scheduled_runs_per_day` integer
      - `refresh_limit_per_run` integer
      - `scheduled_daily_capacity` integer, required
      - `required_daily_syncs` integer, required
      - `utilization` number, required
      - `headroom` integer, required
      - `target_feasible` boolean, required
    - `priority_preview` object[]
    - `refresh_due_preview` object[]
  - `derived` object

---

[API](https://skmtc.dev/git/apis/git-top-agent-api.md) · [All operations](https://skmtc.dev/git/apis/git-top-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/git/apis/git-top-agent-api/revisions/c9ebf661ef6d?raw)