---
title: "Set Sync Enabled"
method: PUT
path: "/developer/settlement-metrics/sync"
tags: ["Developer", "Developer - Settlement Metrics"]
---

# Set Sync Enabled

`PUT /developer/settlement-metrics/sync`

## Request

- Base URL: `https://api.openintake.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openintake.ai/developer/settlement-metrics/sync`
- Auth: none declared

Per-customer source-sync opt-in. Off keeps seeded/demo settlement data as-is.

## Request body

- SyncEnabledInput
  - `enabled` boolean, required

## Response `200`

Successful Response

- MetricsStatus
  - `customer_name` string
  - `settings` MetricsSettings, required
    - `timezone` string
    - `teams` MetricTeam[]
      - `id` string, required
      - `name` string, required
      - `color` string, required
      - `transfer_destination_id` string, uuid, nullable
      - `excluded` boolean
    - `defaults` DisplaySettings
      - `team_ids` string[]
      - `periods` string[]
      - `rotation_seconds` integer
      - `major_threshold` integer
      - `sound_enabled` boolean
      - `volume` number
      - `quiet_start` integer, nullable
      - `quiet_end` integer, nullable
      - `show_race` boolean
      - `show_activity` boolean
      - `show_last_month` boolean
      - `show_retained` boolean
      - `scale` number
      - `theme` 'default' | 'monogram' | 'monogram_light' | 'cream'
    - `hide_last_month` boolean
    - `settled_by_ignored_staff_ids` integer[]
  - `sync_enabled` boolean
  - `source_synced_at` string, date-time, nullable
  - `source_error` string, nullable
  - `unattributed_count` integer
  - `unattributed_amount` number
  - `config_version` integer

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-06** `dbd6e3ee7afe`: 1 info
  - added the optional property `settings/defaults/theme` to the response with the `200` status
- **2026-10-02** `cbec4df5dc85`: 2 info
  - added the optional property `settings/defaults/show_retained` to the response with the `200` status
  - added the optional property `settings/settled_by_ignored_staff_ids` to the response with the `200` status
- **2026-09-29** `318400082d74`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openintake/apis/openintake-api/changes/developer/settlement-metrics/sync/put.md)

---

[API](https://skmtc.dev/openintake/apis/openintake-api.md) - [All operations](https://skmtc.dev/openintake/apis/openintake-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openintake/apis/openintake-api/revisions/de90a8dcbc07?raw)