# swipe

Swipe up, down, left or right, from a target or the screen center.

Swipe up, down, left or right, from a target or the screen center.

| | |
|---|---|
| REST operation | [`act`](/reference/rest/actions/#act) (`POST /v1/devices/{deviceId}/actions`) |
| Action type | `swipe` |
| Needs a device | yes |
| Read only | no |
| Profiles | `core`, `testing`, `full` |

## Parameters

| Name | Required | Type | Goes to | What it is |
|---|---|---|---|---|
| `device_id` | yes | string | path `deviceId` | Stable device id such as `ios:00008120-001A2B3C4D5E6F70` or `android:R58M123ABC`. |
| `lease` | no | string | header `Silan-Lease` | Lease token when the device is claimed. |
| `direction` | yes | `up`, `down`, `left`, `right` | body `action.direction` |  |
| `from` | no | object | body `action.from` | Exactly one of a point, an element ref from the latest observation, or a query. |
| `distance` | no | number | body `action.distance` | Fraction of the screen. |
| `speed` | no | `slow`, `medium`, `fast` | body `action.speed` |  |
| `return` | no | object | body `returning` |  |

## Example call

```text
swipe({ device_id: "ios:00008120-001A2B3C4D5E6F70", direction: … })
```