Skip to main content
Each phone connected to TapKit has configurable settings that control its default behavior. These settings persist across sessions and can be managed via the API or dashboard.

​
Available Settings

​
Typing Method

The default typing method used when type_text() is called without an explicit method parameter.
ValueDescription
shortcutUse iOS Shortcut for clipboard-based typing (recommended)
keysSimulate individual keystrokes via keyboard extension
See Typing for detailed explanations of each method.

​
Speed

Controls the speed of switch control scanning and automation. This affects how quickly gestures and actions are performed.
ValueDescription
30Slower scanning speed - more reliable on slower devices
90Faster scanning speed - better for newer devices
Higher speed values mean faster automation but may be less reliable on older devices or in apps with complex UI. If you’re experiencing missed taps or unreliable gestures, try lowering the speed.

​
Reading Settings

Use the SDK to retrieve the current settings for a phone: 
from tapkit import TapKitClient

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

settings = phone.get_settings()
print(f"Typing method: {settings.typing_method}")
print(f"Speed: {settings.speed}")
Or via the API directly: 
curl https://api.tapkit.ai/v1/phones/{phone_id}/settings \
  -H "X-API-Key: joot_your_api_key"

​
Updating Settings

Update one or more settings with a PATCH request. Only include the fields you want to change: 
# Update just the typing method
phone.update_settings(typing_method="shortcut")

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

# Update both
phone.update_settings(typing_method="shortcut", speed=90)
Or via the API: 
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}'

​
Best Practices

  • Start with shortcut typing method - It’s faster and more reliable for most use cases
  • Use slower speed for reliability - If you’re seeing missed gestures, reduce the speed to 30
  • Configure once, use everywhere - Set your preferred defaults so you don’t need to specify them on every call