---
title: "Update Device"
method: PUT
path: "/developer/settlement-metrics/devices/{device_id}"
tags: ["Developer", "Developer - Settlement Metrics"]
---

# Update Device

`PUT /developer/settlement-metrics/devices/{device_id}`

## 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/devices/{device_id}`
- Auth: none declared

## Path parameters

- `device_id` string, uuid, required

## Request body

- DeviceInput
  - `name` string, required
  - `display` 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'

## Response `200`

Successful Response

- DeviceResponse
  - `name` string, required
  - `display` 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'
  - `device_id` string, uuid, required
  - `created_at` string, date-time, required
  - `last_seen_at` string, date-time, nullable
  - `revoked_at` string, date-time, nullable
  - `app_version` string, nullable
  - `config_version` integer, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-06** `dbd6e3ee7afe`: 2 info
  - added the new optional request property `display/theme`
  - added the optional property `display/theme` to the response with the `200` status
- **2026-10-02** `cbec4df5dc85`: 2 info
  - added the new optional request property `display/show_retained`
  - added the optional property `display/show_retained` to the response with the `200` status
- **2026-09-29** `318400082d74`: 2 warning, 2 info
  - added the new `quarter` enum value to the `display/periods/items/` response property for the response status `200`
  - added the new `year` enum value to the `display/periods/items/` response property for the response status `200`
  - added the new `quarter` enum value to the request property `display/periods/items/`
  - added the new `year` enum value to the request property `display/periods/items/`
- **2026-09-17** `0afcd7c31ce2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openintake/apis/openintake-api/changes/developer/settlement-metrics/devices/:device_id/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)