# move

Starts or stops bot movement and rotations.

```csharp
// See "LSL Helper Functions" page for this function
smartbotsAPI("move", [
  "instruction", "FORWARD",
  "param1", "START"
]);
```

# Variables

The following table shows input values (you send them with the API call) and returned output values.

## Input basic parameters

| Variable | Required | Description |
|----------|----------|-------------|
| action   | yes      | = move      |
| apikey   | yes      | Your personal [developer's API key](/doc/developers-api-key-tw8bQj4LSJ) |
| botname  | yes      | Your bot's SL login |
| secret   | yes      | [Bot access code](https://www.mysmartbots.com/docs/Bot_access_code) of your bot |
| dataType | optional | Set to "json" to get JSON reply instead of URL-encoded string |
| custom   | optional | The custom data (string) to be passed back to caller script. This value will be returned back to the caller in HTTP response |

## Input

| Variable | Required | Description |
|----------|----------|-------------|
| instruction | yes      | The movement instruction. One of the following:<br>`FORWARD` — start/stop forward movement<br>`BACKWARD` — start/stop backward movement<br>`LEFT` — start/stop turning left<br>`RIGHT` — start/stop turning right<br>`FLY` — start/stop flying<br>`STOP` — stops all movements |
| param1   | yes      | Value which controls the `instruction`completion:<br><br>`START` — starts instruction<br>`STOP` — stops instruction<br><br>(This value is ignored for the`STOP` instruction.) |

## Output

*(To be received in* `*http_response*` *LSL event, see* [*docs for details*](/doc/doing-http-api-calls-c6FSEMF7bP)*)*

| Variable | Description |
|----------|-------------|
| result   | OK - command completed successfully<br>FAIL - command failed |
| resulttext | Detailed reason for the failure |
| custom   | The value from input "custom" parameter. See above |

# Examples

**Bot starts moving forward:**

```
action=move&instruction=FORWARD&param1=START
```

**Bot stops moving forward:**

```
action=move&instruction=FORWARD&param1=STOP
```

**Bot stops all movements and turns:**

```
action=move&instruction=STOP
```