> For AI agents: the documentation index is at https://docs.gethandup.dev/llms.txt. Append .md to any page URL (without the trailing slash) for Markdown, for example https://docs.gethandup.dev/cli.md.

# device_update

`PATCH /v1/devices/{id}`

Local only. Update enabled, push, or scope (view or decide); at least one field is required. Muting push preserves API/event access. Scope changes apply immediately. Disabled devices get 403 and their event WebSockets close with code 4403.

## Parameters

### Path Parameters

- **id** (required): `string`

## Request Body required

Media type: `application/json`

`object`

- **enabled**: `boolean | null`
- **push**: `boolean | null`
- **scope**: `string | null`

  Allowed values: `view` `decide`

## Responses

### 200

Media type: `application/json`

`object`

A paired remote device. The bearer token itself is never stored; only its
SHA-256 digest is (see `remote::hash_token`).

- **id** (required): `string`
- **name** (required): `string`
- **scope** (required): `string`

  `view` (read-only) or `decide` (adds decision, cancel and test requests).

- **enabled** (required): `boolean`
- **push** (required): `boolean`
- **created_at** (required): `integer` format: int64, >= 0
- **last_seen**: `integer | null` format: int64, >= 0

### 400

Invalid or empty body; submit scope cannot be changed

### 404

Unknown device
