---
title: "Get device settings"
method: GET
path: "/devices/{id}/settings"
tags: ["Devices"]
---

# Get device settings

`GET /devices/{id}/settings`

## Request

- Base URL: `https://app.italic.com/api/v2`
- URL: `https://app.italic.com/api/v2/devices/{id}/settings`
- Auth: HTTP bearer

Required permission: settings:read.

## Path parameters

- `id` string, required

## Response `200`

Success. Writes without read permission return an ID and revision only.

- SettingsResult
  - `settings` DeviceSettings, required
    - `inputs` object, required
      - `hold` 'clip' | 'memo'
      - `doubleTap` 'clip' | 'memo'
      - `tripleTap` 'clip' | 'memo'
      - `recordButton` 'clip' | 'memo'
      - `pushToTalk` 'clip' | 'memo'
      - `appRecord` 'clip' | 'memo'

## Other responses

- `default`: Request failed. Errors include a stable code and a readable message.

---

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