POST /device/button

Press and release one hardware button.

This is a device HTTP route. Set DEVICE_URL to your reachable device URL; connection and examples explain how. Do not append this path to the public MCP URL.

Parameters

Parameter	Type	Meaning
`button`	JSON string	home, power, volume_up or volume_down.

Response

JSON {pressed:button}.

Example

curl --fail-with-body "$DEVICE_URL/device/button" \
  -H 'Content-Type: application/json' \
  -d '{"button":"home"}'

Notes

Does not bypass a passcode. Returns 503 when touch input is unavailable.

Check the HTTP status and any JSON error. HTTP workflows and error handling explain shared limits. All endpoints.