# Sharing

## POST `/api/1/vehicles/{id}/command/share`

Sends a location for the car to start navigation or play a video in theatre mode.

These docs take from the Android app, which sends the data in JSON form. However, a [URL-encoded](https://en.wikipedia.org/wiki/Percent-encoding) POST body will work as well. The basic format to a request looks like this:

```json
{
  "type": "share_ext_content_raw",
  "value": {
    "android.intent.extra.TEXT": "123 Main St, City, ST 12345\n\nhttps://goo.gl/maps/X"
  },
  "locale": "en-US",
  "timestamp_ms": "1539465730"
}
```

Note: This API was previously `navigation_request`, but has been updated to support video links as well.

### Parameters

| Parameter                         | Example                     | Description                                                                                                                         |
| --------------------------------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| type                              | share\_ext\_content\_raw    | Must be `share_ext_content_raw`.                                                                                                    |
| locale                            | en-US                       | The locale for the navigation request. [ISO 639-1 standard language codes](https://www.andiamo.co.uk/resources/iso-language-codes/) |
| timestamp\_ms                     | 1539465730                  | The current UNIX timestamp.                                                                                                         |
| value\[android.intent.extra.TEXT] | 123 Main St, City, ST 12345 | The address or video URL to set as the navigation destination.                                                                      |

### Response

```json
{
  "reason": "",
  "result": true
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tesla-api.timdorr.com/vehicle/commands/sharing.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.