# teleport

Teleports bot to specific location.

```snippet http-api-variables-OmJyUigTgO
```

```snippet http-api-input-basic-parameters-5FcVlaJbq0 action="teleport"
```

```snippet http-api-input-q5yvAagqsZ
location             | yes      | address of the new location<br><br>Format: Region name/X/Y/Z<br><br>Use HOME instead of location to send the bot home (see examples below).
skip_saving_location | optional | Set to 1 or true to AVOID saving location as permanent. See comments below.
```

```snippet http-api-output-JAwUcmg7i7
```

# Comments

## skip_saving_location

By default bot saves the "location" you specify as base location (same as "Bot base location" in Bot Control Panel). This is a historical behavior, and it makes your bot stay in this location (on sim restart, for example).

You may not want bot to stick to the specified location. Set `skip_saving_location` to `1` or `true` and bot won't set the destination as permanent. It will stay there until teleported further, or sim restarted.

# Examples

Teleport bot to SmartBots office:

```
action=teleport&location=DuoLife/128/128/20
```

Teleport bot to its home location:

```
action=teleport&location=HOME
```