> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tapkit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Settings

> Update phone settings

Update settings for a phone. Supports partial updates - only include the fields you want to change.

## Request

```bash theme={null}
curl -X PATCH https://api.tapkit.ai/v1/phones/{phone_id}/settings \
  -H "X-API-Key: joot_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"typing_method": "shortcut", "speed": 90}'
```

### Path Parameters

| Parameter  | Type     | Description          |
| ---------- | -------- | -------------------- |
| `phone_id` | `string` | The phone identifier |

### Request Body

```json theme={null}
{
  "typing_method": "shortcut",
  "speed": 90
}
```

| Field           | Type     | Required | Description                                                              |
| --------------- | -------- | -------- | ------------------------------------------------------------------------ |
| `typing_method` | `string` | No       | Typing method: `"keys"`, `"paste"`, `"shortcut"`, or `"shortcut_legacy"` |
| `speed`         | `number` | No       | Switch control scanning speed: `30` (slow) or `90` (fast)                |
| `display_name`  | `string` | No       | Custom display name for the phone                                        |

## Response

Returns the full phone object with updated settings. See [List Phones](/api-reference/phones/list-phones) for the complete response schema.

## Examples

### Update Typing Method Only

```bash theme={null}
curl -X PATCH https://api.tapkit.ai/v1/phones/{phone_id}/settings \
  -H "X-API-Key: joot_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"typing_method": "shortcut"}'
```

### Update Speed Only

```bash theme={null}
curl -X PATCH https://api.tapkit.ai/v1/phones/{phone_id}/settings \
  -H "X-API-Key: joot_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"speed": 30}'
```

### Python

```python theme={null}
import requests

response = requests.patch(
    "https://api.tapkit.ai/v1/phones/{phone_id}/settings",
    headers={
        "X-API-Key": "joot_...",
        "Content-Type": "application/json"
    },
    json={"typing_method": "shortcut", "speed": 90}
)
phone = response.json()
print(f"Updated settings: {phone['typing_method']}, speed {phone['speed']}")
```

### SDK

```python theme={null}
from tapkit import TapKitClient

client = TapKitClient(api_key="joot_...")
phone = client.get_phone("phone_id")

# Update just typing method
phone.update_settings(typing_method="shortcut")

# Update just speed
phone.update_settings(speed=90)

# Update both
phone.update_settings(typing_method="shortcut", speed=90)
```

## Notes

* Partial updates are supported - omit fields you don't want to change
* See [Phone Settings](/sdk/settings) for detailed explanations of each setting
* See [Typing](/sdk/typing) for information about typing methods