# Apps API

An AuterionOS app can use multiple APIs. The available APIs are determined by the target AuterionOS version, as well as the used API level specified in the app.

## Specifying API versions

Each AuterionOS app targets a specific API level. The API level an app targets, is specified in the `auterion-app.yml` file like so:

```
auterion-api-version: 2
```

## Available API versions

The following table identifies the feature sets of the different Auterion Apps API versions. Both versions are supported by auterion-cli, but apps targeting older versions of AuterionOS will have to be restricted to older API versions.

### Minimum AuterionOS version per API level

Newer versions of the Apps API are supported by more recent AuterionOS releases.

<table><thead><tr><th width="211">Apps API Version</th><th width="270">Minimum AuterionOS</th></tr></thead><tbody><tr><td>v1</td><td>2.7</td></tr><tr><td>v2</td><td>2.10</td></tr><tr><td>v3</td><td>3.2.9</td></tr><tr><td>v4</td><td>3.4.0</td></tr><tr><td>v6</td><td>4.1.0</td></tr><tr><td>v7</td><td>4.3.0</td></tr></tbody></table>

### Feature comparison of API versions

<table><thead><tr><th width="269.3333333333333">Feature</th><th width="90" data-type="checkbox">API v1</th><th width="90" data-type="checkbox">API v2</th><th width="90" data-type="checkbox">API v3</th><th width="91" data-type="checkbox">API v4</th><th width="93" data-type="checkbox">API v6</th><th data-type="checkbox">API v7</th></tr></thead><tbody><tr><td>Host Docker Network</td><td>true</td><td>true</td><td>true</td><td>true</td><td>true</td><td>true</td></tr><tr><td>Virtual Docker Network, bridged</td><td>false</td><td>true</td><td>true</td><td>true</td><td>true</td><td>true</td></tr><tr><td><a href="/pages/xlZzdbHX7JamEjnVlk3A">Sensor Data</a></td><td>true</td><td>true</td><td>true</td><td>true</td><td>true</td><td>true</td></tr><tr><td><a href="/pages/1lebMkkzbJOIawO9Rdpr">Video Stream</a></td><td>true</td><td>true</td><td>true</td><td>true</td><td>true</td><td>true</td></tr><tr><td><a href="/pages/tEiYlbOZHGggDpUUP89h">Photos</a></td><td>true</td><td>true</td><td>true</td><td>true</td><td>true</td><td>true</td></tr><tr><td><a href="/pages/RTztjWrs8athMUzFgEmE">Hardware Peripherals</a></td><td>true</td><td>true</td><td>true</td><td>true</td><td>true</td><td>true</td></tr><tr><td><a href="/pages/q0gb9xPrC0Zgnfx5fdyd">Persistent storage</a></td><td>true</td><td>true</td><td>true</td><td>true</td><td>true</td><td>true</td></tr><tr><td><a href="/pages/VHjJoEiebxzxo0Z4120a">MAVLink</a></td><td>true</td><td>true</td><td>true</td><td>true</td><td>true</td><td>true</td></tr><tr><td><a href="/pages/zeNXz2TrqHNYkAnhad3B">Native Docker Compose</a></td><td>true</td><td>true</td><td>true</td><td>true</td><td>true</td><td>true</td></tr><tr><td><a href="/pages/OoyOtJqfY5pM6fp4iS1l">App settings</a></td><td>true</td><td>true</td><td>true</td><td>true</td><td>true</td><td>true</td></tr><tr><td><a href="/pages/kZyLDcI8fOmVS9ruAKbI">User Web Interfaces</a></td><td>false</td><td>true</td><td>true</td><td>true</td><td>true</td><td>true</td></tr><tr><td><a href="/pages/YzJNpOwIjQsV5qE9Seos">Debugging Apps with SSH</a></td><td>false</td><td>true</td><td>true</td><td>true</td><td>true</td><td>true</td></tr><tr><td><a href="/pages/jAlzDVOA3wfspY6BxKjU">DDS/ROS2 Configuration</a></td><td>false</td><td>false</td><td>false</td><td>true</td><td>true</td><td>true</td></tr><tr><td><a href="/pages/eN70by8jTpFFWbz3HQVH">Build Arguments</a></td><td>false</td><td>false</td><td>true</td><td>true</td><td>true</td><td>true</td></tr><tr><td><a href="/pages/EATxIYIAVzv7LkFzakhx">Logging App messages</a></td><td>false</td><td>false</td><td>true</td><td>true</td><td>true</td><td>true</td></tr><tr><td><a href="/pages/wA9IcLKIXJOl3sSw4qYv">Auterion SDK</a></td><td>false</td><td>false</td><td>true</td><td>true</td><td>true</td><td>true</td></tr><tr><td><a href="/pages/OoyOtJqfY5pM6fp4iS1l">Parameters</a></td><td>false</td><td>false</td><td>false</td><td>false</td><td>true</td><td>true</td></tr><tr><td><a href="/pages/g9KuroYAWW1uFD5bGA1U">Mountsets</a></td><td>false</td><td>false</td><td>false</td><td>false</td><td>false</td><td>true</td></tr></tbody></table>

For now, all API versions are supported. Some future versions of AuterionOS may lose support for older API versions. APIs within their version are stable, but APIs may change with newer API versions.


---

# 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://docs.auterion.com/app-development/app-framework/app-framework-1.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.